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You are here 

(parking lot 
water cooler 
conference room 
huddle room 
boss* office 
big boss’ office 
latte bar) 

on your laptop, 
on your 
wireless LAN 


WaveLAN® Wireless Solutions from Lucent free 
everyone in your company from the deskbound, 
officebound network. 

With WaveLAN/IEEE Turbo 11Mb Cards, people 
can stay connected, and work productively at the 
speed of Ethernet anywhere they meet, greet or 
get inspired. Standards*based WaveLAN makes 
wireless LANs truly efficient, fast and affordable. 

See how you can boost your productivity at 
1-800-WAVE LAN or www.wavelan.com. 


We make the things that 
make communications work.™ 
























**Without a doubly the Premiere Resource Editor 
for the Mae OS ... A wealth of time-saving tools.” 

- MacUser Magazine Eddy Awards 

"A distinct improvement over Applets ResEdit ” 

— MacTech Magazine 

**Ev€ry Mac OS developer should own a copy of Resorcerer " 

- Leonard Rosenthol, Aladdin Systems 

*y^ithout Resorcerer, our localization efforts would Umk like a ^ 

Tower ofBabeL Dont do product without Ur 

“ Greg Galanos, CEO and President, Metrowerks 

""Resorcerer^s data template system is amazing,"" 

- Bill Goodman, author of Smaller Installer and Compact Pro 

^^Resorcerer Rocks! Buy it, you will NOT regret it."" 

- Joe Zohkiw, author of A Fragment of Your Imagination 

"Resoreerer will pay for itself many times over in saved time and effort. "" 

- MacUser review 

""The template that disassembles PJCTs is awesomer A 

- Bill Steinberg, author of Pyro! and PBTools 

“Kesrorcerer proved indispensibh in its own creation!"" 

- Doug McKenna, author of Resorcerer 
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Version 2.0 



• Very fast, HFS browser for viewing file tree of all volumes 

• Extensibility for new Resorcerer Apprentices (CFM plug-ins) 
•New AppleScript Dictionary (*aete’) Apprentice Editor 

• MacOS 8 Appearance Manager-sawy Control Editor 

• PowerPlant text traits and menu command support 

• Complete AIFF sound tile disassembly template 

• Big-, little-, and even mixed-endian template parsing 

• Anto-backup during file saves; folder attribute editing 

• Ships with PowerPC native, fat, and 68K versions 



Requires System 7.0 or greater, 
1.5MB RAM, CD-ROM 


Standard price: $256 {decimal) 
Website price: $128 - $256 
(Educational, quantity, or 
other discounts available) 


Fully supported; it's easier, faster, and more productive than ResEdit 
Safer memory-based, not disk-file-based, design and operation 
All file information and common commands in one easy-to-use window 
Compares resource files, and even edits your data forks as well 
Visible, accumulating, editable scrap 

Searches and ope ns/mark s/s elects resources by text content 
Makes global resource ID or type changes easily and safely 
Builds resource files from simple Rez-like scripts 
Most editors DeRez directly to the clipboard 

All graphic editors support screen-copying or partial screen-copying 
Hot-linking Value Converter for editing 32 bits in a dozen formats 
Its own 32-bit List Mgr can open and edit very large data structures 
Templates can pre- and post-process any arbitrary data structure 
Includes nearly 200 templates for common system resources 
TMPLs for Installer, MacApp, QT, Balloons, AppleEvent, GX, etc. 

Full integrated support for editing color dialogs and menus 
Try out balloons, 'ictb’s, lists and popups, even create C source code 
Integrated single-window Hex/Code Editor, with patching, searching 
Editors for cursors, versions, pictures, bundles, and lots more 
Relied on by thousands of Macintosh developers around the world 


Includes: Electronic documentation 
60-day Money-Back Guarantee 
Domestic standard shipping 


Payment: Check, PO's, or Visa/MC 
Taxes: Colorado customers only 


Extras (call, fax, or email us): 


All grapl 
Hot-link: 


y,L.£Ui, XeLA, U.D/ 

COD, FedEx, UT^ Blue/Eed, 


International Shipping 


MATHEM^STHETICS, INC. 

PO Box 298 

Boulder, CO 80306-0298 USA 
Phone: (303) 440-0707 
Fax: (303) 440-0504 
resorcerer@niathemaesthetics.com 


To order by credit card, or to get the latest news, bug fixes, updates, and apprentices, visit our website. 


www.mathemaesthetics.com 
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VIEWPOINT 


hy Kas Ihomas 


In the Mac workl, it's taken as axiomatic tliat the Mac user 
exix'ricncc is lx.‘itcr — in every way iliai counts — ifian the 
Witidows user experience, and tliiit die Mac, as a platfonii, offers 
[:>erformance that is alhaiound superior to Winrel offerings, lliem Ls 
some IrulJe of course, to the latter .sialemeni Rut, the former 
proposition (that tlie Mac user experience is sy|x:rior to tlie ncxt“tx.\st 
alternative) needs critiatl reexamination. 

It’s time for its to stand back and ask ourselves how much 
l:>etter the Mac riser experience really is. If we're honc-st wiili 
ourselves, we'll say: “Not much.’’ 

A visitor from Mai's who hmded on t^art]^ right now would Uike 
a Icxjk at a Mac cfxnpiRcT and a lintel maciiine and pnonounce 
tlieiii pietty much the siutie. Tliey show colorful icoas on a 
desktop. Tliey Ixith am weird noises out of little spetikei's. And 
tiiey lx)Lh have i)lt>ated operating systems that serve up fnghteningly 
arcane messages from time to time or allow die machine to 
freeze up altogether 

Tlie user ex[ierient:e offereti by a Mac was, at one time, 
signilicantly different from — and k^tter than — tlie computing 
experience offered by 'Ihe Otlier Guys. But, in tlie jxist decade, 
dedifferentiation has caught up with the Mac OS. Apple Ims missed 
,some imponant o[>|X)nunuics to maintain iis feat! in OS design, and 
it's sUuling to huit. 

One area w^hei^ the Mac could clearly redefine the computing 
cxfx:ricnce is in “instani on'’ lxx)ting. Tlie Mac now got's a step in 
tills LliieGion by ollering an enhanced “sleep*’ mtxle for desktop 
macliinc^, to give non-lknverBook Lisen> tlie illusion of an instant- 
on/rio-waii lxx)t pRx:ess. All well and gcxxl. Mow Apple .should go 
a step furtlier raid try to ivduee^— not i>y seconds, but by minutes 
— the time required lor a eold Ixxit of a worst-case machine (i.e., 
one loaded with the nxist fx>pular lour or five dozen exterisioas and 
drivers). Has no one in Cupertino found it iionic tliat one of lire 
hottest sliaieware System tixteiisions on the World Wide Web right 
now is Man: Moini's Sianiip Douhler, which cuts Mac cold-l'>oot 
times rougiiiy in Ixdff 

llie tact tkit St:iitLi]:j lX)ubler has gone double-platinum is 
telling, li ineiins Apple has work to do. 

A more important question, perhaps, Ls why anyone .shoiikl 
ever have to rebexx a machine in the first place. An o|XTatiiig 
system that lets a process (or a user) get so out of control that the 
liost machine crashes, freezes, or goes off into deep space is — 
some would say — not much of an ojKTating system. Tiicre are 
(ximpiiter users in the Unix w^irki who literally can't remember 
the last Lime their machines locked up, liecaiise it's such a rare 
event. And yet Apple still ships boxes tliat (let’s Ix' honest) 
regularly loc'k up or zone out. Isn’t tills (once again) genuinely 
Windows-like behavior? Does Apple really want to Lie associated 
w ith this son of tiling any longer? 

But, even ff we grant that ocaisiorctlly — however raiely — a 
mat'lilne is bound to encounter a deep enor c'onclition of some kind, 


cbes ditit really mean we should have to leboot tlie machine? 
Shouldn't there bt. some kind of sophisticated shadcm -c'adiing of die 
maelline’s overall sliite so tliaL when a supposedly unnet:overable 
condition Ls entered, the user can back out of it by escaping to a 
previously known-gexxi state? What’s so impossible alxiut diaf? 

.Snappier overall performanee at the OS level is another issue 
that needs attention. Tlie Mac OS has gotten sluggish over die yean>, 
a tmnd ti^lt Iiegan in 1990 with System 7. (Ag;un, not coincidentally, 
ill is trend has floated a flotilla of besiselling Randaidware utilities 
with “IXiubler” in the name.) Much of the latency involved in 
launching Fintler processes is, of course, due to hard disk action. 
Here’s another aiea where Steve could rock [xsople's perceptions — 
l>y gelling rid of built-in hard disks, 

Everything tbit’s tione now^ on haid disks can be done much 
faster on vimial ( IfAM) disks. For data proteaion, KAMdLsk contents 
would be continuously (and aulomaiiially) wdllen to the Tniemci 
(i.e., to jx:rsonal or coqxirate FW .sites). 'fliLs would require a 
constant 24/7 net hrxdcup, of course. Those who don’t yet bive sudi 
amenities could, of course, buy inexpensive IxK'kup storage in the 
form of CD-R, DVD^ or (yes) uldTasliioned IDE drives. 

'Ihe only legit teclinical objection, it seems to me, to using 
DRAM as default stomge would lx* casi. Bill, think what a unilateral 
decision liy Apple to use DRAM for data storage w(>uld do to DRAM 
prices! (Qin anyone say TISR?) 

.Sfxin ii may aciually Ixf feasible just to write one's backup data 
to a Cist'o backlxine, a “ping netw^oH<^” or a .satellite uplink. Not to 
any given medium, mind you — not to tlie ntxlcs al eitJier end of 
the hacklxine, but to ihe bucklxme itself. Not to the satellite, hut to 
the space txtween ihe earth and the siitellite. Imagine that you could 
fire data skywaid at a rate of 100 megaliertz (which Is certainly 
feasible; tiiafs in tlie low^ FM kmd). Su[i|xise theie is a one-second 
|■t>undtrip Lime u> the .satellite. If yon weie to write continuously to 
tlie sky, dieie would always Ix’ 1(X) megabits of your dtUt in tiatisit 
— too megiihils in storage, 'lb retrieve any ]xirt of it, just wait for the 
part you want, and giab it. ('Tlie reader is left to prove tliat the 
average “sc'ek time” wotild lx 5fX) msec.) 

Apple bis done a gcxxl jdi over the years — imylie a bit too 
good — of "[x>li.shing pixels" in the ever-pnecious Mac operating 
system, even gening lo the trouble of adding a Pixel Polish Miinager 
(1 Ixdieve tlie [x?litiailly conect name is Appearance Manager) to tlie 
OS. No question alx)Ut it, we bive the shmiesi pixels. 

Bui, it’s lime to recognize trial meaningful progress in operating 
S 7 Steins no longer bis tJie slighic*st tiling to do witli widget design, 
dkilog apixmances, contextual menus, pen^onalization, Login hy 
Voice Recognition, or (GexJ help us) ballcxin help. 

What tlie world could use riglit now is a personal 
.supercomputer that comes on like a light bulb, has zeio liaid<lLsk 
latency, and never Icx'ks up. 

Ijet’s liope tile Otjier Guys don't do it first. 
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The key te 
thinking different... 


Question: Is MacHASP USB’^ a 
software security key or a 
sales tool? 

Answer: It's both! 

MacHASP USB is the world's first 
software protection key for the 
iMac. It gives you sophisticated 
license enforcement and compre¬ 
hensive protection against illegal 
use... in other words, real security. 

Then it gives you a big seiiing 
advantage. 

With MacHASP USB, you can 
license multiple software modules 
and applications. You can instantly 
unlock or upgrade them in the 
field. Plus you can freely distribute 
demos. 

Bottom line: MacHASP USB locks 
out illegal users and unlocks your 


full sales potential - without 
getting in anyone's way. Call now 
to request a Developer’s Kit and 
our newly published guide to USB 
features and benefits. 

*For all USB-equfpped Macs mnning an OS 
with USB support Fully compatible with the 
AD8 version of MacHASR 

IW 

MacOS 

USA: 1-800-223-4277 
212-564-5678 
Int’l; 972-3-6362222 

WWW. aks. com/mt 

ALADDIN 

KNOWLEDGE SYSTEMS LTD 


Mac software protection provider, Micro Macro Technoiogies, becomes part 
of Aladdin, giving its customers even better service from the number one name. 





GETTING 

STARTED 


by Dan Parks Sydow 


Carrying On With QuickTime 


More QuickTime 
fundamentals to 
prepare you for the 
power of Apple's digital 
movie system software 


In last month's Getting Started 
article I discussed the wealth of 
features available to programmers 
interested in incorporating into their 
programs QuickTime capabilities. If 
you aren't familiar with QuickTime 
movie playing techniques, you should 
be! Last month you read about the 
basics of QuickTime programming. In 
particular, you learned how your 
application can open a movie from a 
file and then place that movie — 
complete with attached controller — 
in a window. That article closed with 
the mention that a movie could also be 
used without a movie controller. That's 
a technique that may be useful in a 
variety of circumstances, such as 
having a movie play in response t<} 
some user action (a game or 
educational program might include 
this feature). In this article weMl 
conclude our Quick'I'ime introduction 
by providing the details of how your 
program can play a movie without the 
aid of a movie controller Here you1l 
also see how to embed a movie in a 
dialog box and then use standard 
dialog box buttons to play the movie. 


QuickTime Basics Review 

Before jumping into this montli's code, a slum review of 
Uie very basics of Quick'l ime is in order. For more details, 
look over last month's Getting Started article. If' youVe read 
that article, though, don't skip tills .section. Here T also throw 
in one or two new tidbit.s of QuickTime-related code. 

Apple has created the Movie Toolbox to help 
programmers give their applic’ations the ability to play 
movies. This toolbox is a large set of movie-related functions 
to die system software. When you know the Movie Toolbox, 
you know QuickTime, 

A program that makes use of QuickTime needs to verify 
tlial die user's machine has the QuickTime extension 
available. It should also initialize the Movie Toolbox, The 
following code takes care of diesc two tasks: 

OSErr err: 
long result; 

ert “ GestaltC gestaltQuickTime* ^result ); 
if ( err !“ tioErt ) 

DoErrort "VpQuickTiine not present" ) : 

ert = EnterHoviesC): 
if ( err noErr ) 

DoErrorC "\pError initializing the Movie Toolbox** ): 

Before playing a movie, a program needs to open the 
QuickTime file tn which the movie is stored, load the mewie 
data to memory, and then close the file. 

In last mondfs article you saw how to use the standard 
Open file dialog box to give the user die opportunity to choose 
die movie kj play. Here well elalx^rate on a technique briefly 
mentioned in last month's article: how a program can easily 
carry out the movie-opening chore “iK:hind the scenes,” Thar 
LS, hem we'll let the program selea the movie to open, A 
program of coun>e doesn't nmriomly open a movie — the 
selection is typically based on some user action. For instance, 
if the user chooses a Coimectioa Setup item from a Help 
menu, die pnigram would know to open a movie titled 
ConnectSetup.mov to display a movie that walks the user 
through some connection process. 

To specify a movie to opien, your program needs a file 
system specification, or FSSpec, for the file that holds the 
movie. The FSSpec specifies where on disk the movie file 
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is located. If the name of the file that holds the movie is 
known (you're supplying the movie file, so it's name 
should certainly be known), and if the file is to reside in 
the same folder as the application, then the code to create 
the file's FSSpec looks like this: 

^define KApolloKovieName“VpMovieApollo" 

OSErr err: 

FSSpec wovieFileSpec: 

err * FSHakeFSSpecC 0* 0* kApolloMovieNamep 
^ovieFi 1 eSpec ): 

In the al>ove snippet the name of the file to open is 
MovicApoUo (this month's example program plays two 
movies, including one of die launch of the Apollo rocket). 
With the first two arguments to FSMakeFSSpec(> each set to 
0, die movie is expected to be in the same folder as the 
application. If you'd like to group all your program's movies 
in a folder unlbin ihc same folder that holds the applicadon, 
then you'll need to include that folder's name in die third 
argument to FSMakeFSSpec(>. Use a colon between the 
folder name and tlie fde name to indicate that diis is a 
padiname and that the first pan of the name is a folder and 
die second part is a file name. For instance, if stored 
alongside the application was a folder named dien 

the definition of the constant kApolloMovieName would 
become: 

fldflflTie kApolloMovieName ‘‘\pMovles:MovieApollo“ 

The FSSpec returned by FSMakeFSSpecO is now used in 
a call to the Movie TckjIIkix function OpenMovieFile(). The 
three argumenLs this function requires are a pointer to the 
FSSpec. a pointer to a short variable that gets filled in with a 
file reference number, and a file-opening permission level, 

sho r t movieRe fN um: 

err - OpenMovieFile( ScmovioFileSpec. SniovieRefNump 
rsRdPerm ); 

Tlic movie file’s data can now be loaded to memory. A call 
to the Movie Toolbox funf:tion NewMovieFromFile() does that: 

Hovie theMovie; 

OSErr err: 
short movieRefNuiEi: 
short resID " 0: 

Str255 n&me; 

Bo olean chan ged: 

err “ NewMovieFromFlle C AtbeMovie. moviGfiefNuiii, &resID, 
name, 

newMovieActive, Schanged ); 

'llie parameter list to NewMovieFromFile() was described 
in detail last mondi. Here’s a brief recap. The first argument, 
theMovie, holds a pointer to the memory diat contains the 
movie data. 'l1ie second argument, movieRefNum, is the 
reference numlier returned by the call to OpenMovieFHe(). 
Tile diird argument, resID, is the resource ID of the movie’s 
moov resource (use 0 if a file holds a single movie, as is 
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typically tiie case). The fourrh argument, name, gets filled in 
with the name of the moov resource (this resource is often 
unnamed, in which case nil is returned). The fifth argument, 
newMovieActive, is an Apple-defined constant tiiat specifies 
that the newly created movie be active (ready to play). 
Finaliy, the sixth argument, changed, indicates whether or not 
the Movie Too11k>x needed to alter any data as it Itjaded 
movie data to memory (it shouldn't have to). 

Your program now has the mt>vie data in memory, so 
the movie file can be closed; 

CloseMovieFile{ tnovitfRefNum ) : 

Displaying a Muvn* in a Window (ok Dialog Box) 
last month you saw how to display a movie and a mofvie 
conln>iler in a window. Here we'll simply display a movie in 
a window (or a dialog box — the process is similar). First, 
open the window or dialog box: 

Wind owPt r t he W1nd ow: 

theWindow “ GetNewCWlndow( kWINDResID» nil, 

(WlndowPtr) -It. ): 

Next, set the movie's display coordinate system to that of 
the window or dia!t)g in which the movie is to be 
played. As you saw last montli, a c'all to the Movie Toolbox 
function SetMovieGWor(d() sets the disf)lay ctMjrdinaie system 
of the movie named in the first argument to tliat of the 
window named in the second argument: 

SetMovleGWorldt theMovie, (CGrafPtr)theWindow, nil 3; 

Next, get tlie dimensions oi the movie in order to resize 
tile window (or in order to approprialely place the movie in 
a dialog box that’s bjger than the movie). A call to the Movie 
Toolbox functitjn GetMovieBox() provides tliat information in 
the form of a rectangle that holds the dimensions of a movie: 

Rtjct box; 

GetMqvieBoxt tbeMovle. ibox ): 

The left and top ctnirdinates in the rectangle returned by 
GetMovieBoxQ may each be 0, in which case the right and 
bottom c:oorcli nates reveal the movic.s width and height, 
respectively. Hewever, the left and top coordinates might not 
each be 0. So ifs wise to make a call to OffsetRectO to force 
those two ccK>rdiriates to 0: 

OffserReett fitbox, *box.left. -box.top ); 

N«>w call the Movie Toolbox function SetMovieBox() to 
make the new, offset values the boundaries for the rettangle 
that defines the size uf the movie: 

SetMovleBox( theMovle, 6fbox ): 

If you want die window that's to display die movie to lx: 
the exact size of the movie, dien new's the time to resize diat 
window — just call SizeWindow() using die right and bottom 


coordiruites of reaangle box as the width and height of die 
window. In our example prograiii we won’t do that. Instead, 
well furdier adjust the coordinates of box to ixxsition the movie 
in a dialog box that’s larger than the movie. 

Playing a Movip Without a Movu- Copvmouj-B 

If you want to play a movie automatically after the 
movie is displayed, or if you want to implement your own 
metiiod of letting the user play a movie (as in displaying 
a standard pusii button in a dialog box), then yooH 
forego the movie controller code discussed in last month's 
article. Instead, you 11 make use of a few Movie Toolbox 
functions designed for just this type of movie playing. 

When a movie is saved, it may or may not be saved 
wiiii the first frame designated as the frame to start the 
movie at. Before playing a movie you 11 want lo “rewind" 
the movie by making a call to GoToBeginningOfMovie(). 
After that, the Movie Toolbox function StartMovie{) is 
called to prepare the movie for playing, 

GoToBeginniTTgOfMovie ( theMovie ); 

StartMoviet theMovie ): 

StartMovieO lakes eare of a few tasks such as selling the 
movie's playback rate, but (JiLs routine doesn't actually play 
the movie. To do tliat your program should repeatedly call 
the Movie TtK)lhox ftinction MovresTask(). A single call to 
MoviesTaskO processes only a small part of a movie, updating 
ihe display of the movie by drawing a frame — that's why 
this function is called from within a loop, 'fhe Movie Toolbox 
hinction lsMovieDone() returns a value of true when the 
movie in que.stion has completed, so this funaion can be 
used to determine when the loop should end. 

do 

I 

MovlesTaskt theHovie. 0 ); 

1 

while ( IsMovleDonef theMovle ) ^ false ): 

A single call to MoviesTaskO is c'ap£il>le of servicing, or 
updating, moie titan one movie. Ihe first aiguinent is ilic 
movie TO service, If more liian one mtwie is open, pass a value 
of nil lo specify that all Ofien movies lx.* updated. The second 
aigumeni is ilic number of milliseconds tlie [program is willing 
to give die Movie Toolixix for iis task of servicing movies. Tliis 
Ls the total amount of time to be spend updating the movie or 
movies sjxxriricd in the first atgument. Passing a value of 0 hern 
teUs the Movie Toollx)x lo servke each active movie once. 

When your program is finished with a movie it shcmld 
call DisposeMovieO to release the memory ticcuplcd by the 
movie data: 

DisposeMovi^t theMovio }; 

MorlQT 

Thi,s nfK.)nfh’s program is Moret^T, As we did last month, 
here again ilic example program isn’t menu-driven, Wlicn run, 
displays die dialog box shown in Figure 1. Clicking the 
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Apolb bution rrajlts in the ciisplay and pkiying of a movie of t!ie 
Apollo liftofT— as shown in Figure 2. Wlien the movie fintslies, 
its last frame is left in tlie movie-viewing area. To deiir that area 
and return it to its original light gray sLiUe, click tlte Clear hutlon. 
'lb play a tiiovie of the Venus space prolx^, click ilie Venus 
button. 'lb quit the pnigram, you of course dick the Quit luitton. 



Figure L The MoreQT dialog box. 


( Apollo 1 

[ Venys | 

I Ctear | 

[ Quit I 


Figure 2, Ihe MoreQTprogram as a m<me is playing. 



Creating the MoreQT Resources 

Start the project by oealing a new folder named MoreQT 
in your CodeWanior development folder. Launc'h ResEdii, then 
create a new resource file named MoreQTfsrc. Specify that the 
MoreQT folder as the resource file’s destination, 'lire resource 
file will hold resources of the tyi>es shown in Figure 3^ 


fvkireQd.rsfc 

^ D IS Q Li 

HMT ^le«J Om. DLOO PCI 

□ Piers MoreQTjrm pS 



Figure J. Tfye MoreQT resources. 
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ALRT 128 and DITL 128 resources are used to define the 
program's error-handling alert. There's a second dialog item 
list resource — DITL 129 — that's paired with the file's only 
DLOG resource. Figure 4 shows DLOG 129j while Figure 5 
shows DITL 129. 



figure 4 The DLOG resource. 


□ Dia IPs 129from Moreff jsrt m 


ApoUol^ 

Venusli, 

Qeari^ 

I Quit ilj 



figure 5. The DITL for the one dialog box. 

As shown in Figure 3, tliere's one PICT resource. This 
piciure is used to create the three-dimensional look of the 
movie-playing area in the program's dialog lx>x. To create 
this picture, I first determined die pixel dimensions of one of 
the movies (the two movies are the same size) 1 then used 
my paint program to create a shaded area slightly larger than 
a movie. In Figure 5 you see that the DITL for the dialog box 
includes a picture item that displays this PICT. 

When you run MoreQT you'll notice that the dialog box. 
has a light gray background. This shading is c^asily achieved 
in ResEdit. First, open the dialog box DLOG, then click the 
Custom radio builtjn (refer to Figure 4). Next, click die 
Content box to display a palette of colors that are used to 
define the dialog box background. Choosing a color t:reates 
a detb resource that's automatically added to the resource file 
(see Figure 3). 

Creating the MoreQT Project 

Stan CodeWarrior and choose New Project from the File 
menu. Use the MacOS:C_C++:MacOS Toolbox:MacOS Toolbox 


Multi-Target project stationary for the new project. You earlier 
created a piojcct folder, so uncheck the Create Folder check 
t>ox before clicking the OK bunun. Name the project 
MoreQT.mcp, and make sure the project's destination is the 
MoreQT folder 

Add the MoreQTrsrc resource file to the new project. 
Remove the SillyBalls.rsrc file. You may also remove the ANSI 
Libraries folder from the project window if you w^mt — the 
project doesn’t use any of these libraries. 

If you intend on making a PowerPC veiskm (or fat version) 
of the program, you’ll want to Ixf sure to add the QuickTimeUb 
library to die PowerPC taigets of your pmject. Choose Add File 
from the Project menu and work your way to this library. You’ll 
find it in the Metfowerfes CodeWarrior MacOS Support Libraries: 
MacOS Common folder (if it's not there, search your hard drive 
for it). When you add the library to the project CjodeWarrior will 
display a dialog box asking you which tajgets to add die library 
to. Check die two PPG targets. 

Create a new source code window by choosing New 
from the Fite menu.. Save the window, giving it the name 
MoreQTc, Now choose Add Window from the Project menu to 
add this empty file to the project. Remove the SillyBalls.c 
placeholder file frt)m the projea window. You're all set to 
ty[x; in the .source code. 

To save yourself a bit of typing, go to Mac'iech's ftp site 
at ftp://ftp.mactech.com/src/. ihere you'll find the MoreQT 
source code file available for downloading. 

Walking Throisgh the Sourci? Code 

MoreQTc starts with several constants. The constant 
kALRTResID defines the ID of the ALRT resource used to 
define the error-handling alert. Constant kDLOGResID 
defines the ID of tlie DLOG resource used for the dialog box 
that is to display the QuickTime movie. Constants 
kOuitButton, kClearButton, kApoIloButton, kVenusButtoo, and 
kFrameltem eacli define an item in DITL 129 (refer back to 
Figure 5 to see the relattonshtp between these constants 
and the items in the DITL). Constant kFramePictID is the 
resource ID of the picture used to create the movie-playing 
area picture. Constant kFramePixelSize is die pixel width of 
the frame of the fmme picture. This value wiil be used in 
centering a movie within the movie-playing area. Finally, 
kApolloMovieName and kVenusMovieName are the constants 
that define the names of the two Quick'rime movies that the 
program will use. 



consnmis —— 

——/ 

^define 

kALRTResID 

128 

//define 

kDLOGResID 

129 

//define 

kQuitBiitton 

1 

#dGfine 

kClearButton 

2 

//define 

kApolloBuiton 

3 

//define 

kVenusButton 

4 

//define 

kFraaeltem 

5 

#define 

kFramePictID 

128 

//define 

kFramePixelSise 

4 

//define 

kApo11oMovieNa me 

**\pMQvieApollo'' 

“ApMovieVenuG 

//define 

kVenusMovieName 
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MoreQ'r declares a a^uple of global varial>les. gDone is 
used to signal die end of the program. Variable gMovieDialog 
is a dialog pointer that simplifies access to the items in this 
movie-playing dialog \x:>x, 

/•••*****«™**« global vaiiabics .."^7 

Boolesin gDone = false; 

DialogFtr ^OvieOialog; 

Next come tlie program's function prototypes. 

/*^***“*“*“””* fun<atonii 

void ToolBoxlnlL( void ); 
void OpenDiaiog( void ): 
void LoadAndRunMovie{ Str2S5 movieWame ); 
void DoErrort Str253 errorString ); 


As it did in last month's example (which also relied on 
QuickTime), the ma»n{) function of MoreQT begtas with the 
declaration of two variables that are used in the 
determination of whether QuickTime is present and in Ute 
initialization of the Movie Toolbox. After the Toolbox is 
initialized and the QuickTime-related tests are made, the 
application-defined OpenDialogO function is called. 

main ™-«™-**'**-**-“/ 

void roain( void ) 

I 

OSErr err; 

Tong result: 

ToolBoxTnltf); 

arr ** GastaltC gestaltQuickXinio, ^result ): 

if ( err I- noErr ) 

DoErrort "VpQuickTinie not present"); 

err EnterWovles () : 

if ( orr noErr ) 

DoError( "\pError initializing the Movie Toolbox” 


OpenDialogO ; 

1 


ToolBoxInitO remains the same as previous versions. 
/•*•*****'—^-'nxiiBoxinii 

void ToolSoxInit{ void ) 

i 

InitGtafE &qd,theFort ): 

TnitFonts(); 

TnltWindovsO i 

InitManufiO ; 

TEinitO : 

InitDlalogsC nil ); 

InitCursor() ; 

I 


OpenDialogO opens and controls a standard modal 
dialog box. If you've ever included a non-movable dialog 
box in any of your own programs, then most of the 
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OpenDialogO code siiould look familiar. Tlie routine 
l>egin,s wiih a handful of local variable declarations, then 
the dialog box is c>pened and displayed: 

void 0penDia1og( void ) 

I 

short item: 

shot L type; 

Hyndlo handle: 

Reel rec:t: 

FicHandle framoPict; 

gMovleDialog * UetNewDlalogf kDLOGReslD, nil, 

(WindowPtr)-IL]: 

ShowWlrsdow^ gMovieDialog ]: 

Set Port { gHovieDialog ); 

Next, OpenDialogO *?ntcrs a loop that executes uniil 
the program ends. Each call lo the Tcxilhox funcUon 
ModalDialogO returns ilie item number of a clicked on 
item — if in fact the user did click on an item. This item 
number is then used in a switch statement to determine 
how die program should handle the mouse click. 

while ^ gPone ^ false ) 

I 

ModalDlalog( nil, Sitem ): 

switch ( item ) 

( 

caae kApolloBirtton: 

LoadAndRunHov Ie( kApolioMovieNamf* ); 
break: 

case kVenusRLittoii: 

LoadArjdRufiMovie( kVemisMov k‘Name ): 
break: 

case kCiearButton: 

GetDialogItein( gHovlellialog, kFrameltetn. {(type, 
^bfiiidle, Scirect ) ; 

trameFict - GeLPictureC kFramePictlD ): 

DrawPleturo( framePict, ): 

break; 

case kOuilButton: 
gDane ” trtie; 
break; 

J 

I 

DlspeseDlalogC gKovleDialog ): 

1 

A click on the Apollo or Venus button results in tile 
application-defined funaion LoadAnd Run Movie () playing of 
the a[>propriate QuickTime movie. A click on the Clear 
button results in the displaying of the PICT resource in order 
rt> obscure the niovic“playing area Cwhicli will 1 k" displaying 
the lust frame of the most recently player! movie), Tlic call to 
GelDialogltemO is made to obtain the Ixmndaries of the dialog 
item that holds the picture, A cull to GetPicture() loads the 
picture U> memory, and a cull to DrawPlcture() draws the 
picture at the ItH aiion held in the rectangle reel. A click on 
the Quit button ends the program. 

When the user clicks on either the Apollo or Venus 
button, LoadAndBunMovieO is called. The name of the movie 
is passed to this function, and LoadAadRunMovie{} then docs 
just that — it loads to niciriory the appropriate movie, then 
plays the nuwie once. Almost all of the ctjdc in 


LoadAndRunMovieO was introduced earlier in liiis article. The 
function starts with a slew of kx:at variable declaratioas: 

LoadAiidRuaMuvic 

void LaadAndRunMovie( Str255 movieName ) 

I 

OSErr err: 

FSSpec theFSSpec; 

ghort f ileRofNiun; 

Movie theMovie; 

short movieResID = 0; 

S t r 2 5 S movie Re sKame; 

Boolean altered; 

Rec t box: 

ghort type; 

Handle handle: 

Rect rect: 

A call to FSMakeSpecO creates a file system specification 
for the appropriate movie, 'that FSSpec is then used in a call 
to OpenMovieFiie(). After the movie file is opened, 
NewMovieFromFileO loads the file's movie data to memory, 
WeYe then finished with the movie file, so it can be closed: 

err FSMakeFSSpec( 0, 0, moviaMame, AtbeFSSpec ); 

err = OpenMovieFileC & the FSSpec, SfileRefNuin, 
fsRdPerm ); 

err ^ NewMovleFromEile^ StheMovie* fileRefNum. * 

&movleRefiID, 

pto V i eR e s Name, newHov i eAc t i ve, 

1tered ) ; 

CloseMovieFile C fileRefNimi ): 

Earlier in this article you saw how SetMovieGWorldO | 
matches the display cooidinaie system of a movie to a window. I 
Here ihe same routine Ls used to pair a movie to a dialog lx>x: 

SetMovieGWorld( theMovle. (CGrafPtr)gMovieDiaiog, nil); 

As discussed earlier in this article, GetMovieBoxQ and 
OffsetRectO arc used to get the bounding rectangle of the a 
movie and to then offset the boundaries to (0, 0): 

GptKovieBoxC theMovie, fcbox ): 

OffsetReetC Rbox. box.left* -box. top >: 


I lore, rather than now setting the new boimdaries to tlic 
movie, we first rept>sition the reaaiigle so that it is centered 
in the movie-playing area of the dialog box. The boundaries 
of the movie-playing area arc defined the picture item in tlie 
dialog box, A call to GetDialogItemO gets that picture’s 
btHJndaries. A atll to OffsetRectO shifts die movie’s current 
boundaty rectangle so that iLs top and left sides match die 
coordinates of the picture — with the addition of a few pixels 
to account for the “frame-like'’ shading we’ve given to the 
picture (see Figure 3)- Now we’ve finally got die movie's 
coordinates established, so a call to SetMovieBox{) can he 
made ro lock in these values to the movie: 

GetDiaiogltemC gMovieDialog. kFrameltem. 

Stype* ^handle, direct ): 

OffsetReert &box, rect.left + kFramePixeiSise* 
rect*top + kFramePixelSize ); 

SetMovle&ox( theMovie* &box ): 
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New it\s Lime to play, then dispose of, the movie. The 
following code is unchanged from the discussion earlier 
in this anicle. 

GoToBeginningOfMov let theHov1e )j 
StartMovie( theMovie ): 

do 

I 

HovlesTaskttbeMovle, 0) j 

} 

while ( IsHovieDonet Lhc»Hovle ) = false ); 
DiBposeMovie{ theMovie )i 


DoErrorO is unchanged from prior versions. A call to this 
function results in the posting of an alert that liolds an error 
message. After the alert Is disinlsscd die program ends. 

/ *"**** * “. . DoEmr ... 

void DoErrorC StrZbS errorStrlng ) 

I 

PataffiTeKt C errorString. "Vp". “\p”. ’*\p” ): 

StOpAlertC kALRTRefjID. nil ): 

EKltToShellO ^ 

1 


Running MorhQT 

Run MoreQT by .selecting Run from CodeWarrior’s 
Project menu. After t:ornpiiing the code and building a 
program, CodeWarrior runs the program. I'he dialog f>ox 
will appear. Go ahead and ptay (he movies as often as 
you wish. In between movies, click the Clear button to 
verify iliai it docs in fact ciear_the movie-playing area. 
Wlien finished, click the Quit hulton. 

Till Next Month... 

Last month we introduced (QuickTime and movie 
controllers. This month we carried on with our study of 
adding movie playing capabilities to a program. Study and 
exf^erimetU with the code from both last monili's and this 
month's projects. You 11 warn to get well grounded in 
QuickTime basics — with the powerful and cros.s- 
platform capabilities of QuickTime 4, Apple is 
demonstrating the QuickTime is going to be a key 
tech nr > logy for Mac |)rogrammers to understand,.. Mi 
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Wireless Networking and The AirPort 


Apple and Lucent redefine 
easy networking with the 
AirPort, and 802.11 


Welcome 

This article covers Apple's AirPort, 
ilie wireless networking system 
introduced in July at MacWorld Expo, as 
well as the standards and technology 
l>ehind the AirPort, Along the way, we’fl 
1 ook at oth e r wi re I ess n etwork i ng 
schemes and products, to see how they 
stack up against the AirPort, Well start 
with a Irasic introduction to the AirPort, 
and its connection to the iBfK)k,and to 
other members of the Macintosh family. 
We will also go into a basic history of 
wireless networking, as it pertains to the 
AirPort and the 802,11 standard. Well also 
take a dose look at the 802J1 standard 
itself, and some of the work lucent 
Technologies has done to gel the speed 
and capabilities that now exist out of that 
standard. Next we'll take a look at some 
of the power managemeni and other 
features that are integral to tiie Lucent 
work. Tlien we'll look at the AirPort itself, 
and see how Apple has applied their 
pliikxsophy of “It just works" to wireless 
networking. Finally, we’ll compare the 
AtrPon and 802.11 lo some of the other 
wireless networking schemes. 


Airport Introdooton 

The bigge.si news to come out of the New York MacWorld 
was the iBook, and its wireless networking culpabilities. Although 
1 have no doubt the iBook will become as much a success as the 
iMac, I think the really astounding pait of this announcement was 
the AirPort, Apple's release of an 802d i-compliant wireless 
networking system, llie AirPort is a one-stop wireless networking 
system that runs at common Ethernet speeds. It is cheap enough 
to become an impulse buy for iBook, and other Mac customers. 

Now for the iBook, tlic AirPort Is a great enhancement llie 
iBcxik’s card, which, in dassic Macintosh fashion, is iasanely easy lo 
install, Ls about a hundretl bucks; then add about 300 bucks for the 
AirPort Pod, whicli is die trapse station for AirPort-enabled Macs; a 
person or company can set up a fast, reliable, easy to use and 
maintain wireless network in relatively short older. Even for other 
Miles, the AirPtM is as much of a blessing. With PC cards available, 
and more on the way from Apple and other vendors, such as 
Faralit^n, and PCI cards for the lower and desktop Macs, even non- 
ilkxrks am lake full advantage of the AirPort, (Although not 
mentioned, I'll hazard two predictions abt)uL the iMac. The first is that 
we will be quickly seeing a USBconnecled AirPort device, and llie 
second hi the iMac: will eventually have AirPort networking built-in.) 

The extra plum in tills bowl is the lEFE 802.11 wireless 
networking standard. Since die AirPort is based on this 
standard, any computer with an 802.Uncompliant interface 
device can plug into the AirPort network with no more trouble 
than connecting Macs and PCs or Unix workstations via 
conventional Ethernet. So much of the AirPort techonology is 
based on the 802.1! standard, we shall go into the history of 
802.11 devices and the details of the standard iLself. 

The IEEE 802,11 Specification 

Let's start with some background information an the 
foundation for the AirPort, the IEEE 802.11 standard. This 
standard, defines the way that 802,11-compliant devices 
communicate with each other. It operates at the phy.sic:al, or 


John Welch <jwelch@aer.com> is the Mac and PC Adminisirator for AER Inc., a weather and aimospheric science company 
in Cambridge, Mass. He has over fifteen years of experience at making computers work. His specialty Ls figuring out ways to 
make the Mac do what noliody tliinks it can . 
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hiirdware layer, and the Media Access Control, or MAC kycr. It 
is nol concerned with TCP/IP or AppleTalk, but rather tlie 
undeipinnings, 802,11 defines wireless networking acroas a 
number of bands, or frequencies. These frequencies, in the 
Industrial, Scieotiftc, and Medical, or iSM bands, range from just 
over 900MHz to uppn>xinraiely 5.8 GHz, Tlie ISM bands were 
chosen because of their worldwide availalrility. In practice, due 
to differences of avaikdiility worldwide, 802,11 is primarily 
concerned wiili the 2.4 to 2,5 GHz bands. Tlie differences in 
band availability, ]:>ower l^sagL% and inoduliiLion rules in various 
parts of the world are shown below in fable T 


Countries 

rrequenc)' 

IHuxiinuin RF 

Rules for 


rangf 

pim'Cf level 

DSSSai^ 

HISS 

US., CiiniidaJ 

‘X)2-‘)28Mllz 

jw (m |':rp/ 

DSSS: Refidv'er 

iuid Lulu .^nieriCii 
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:iiul m:u;iiTitiin 
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or more 
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DSSS; Power 

(in\4 3m.T2K) 



spectiiin) 
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HLSS:20 hqis 
nr iiKit'e 


2,471-2,W MIL 

!^>l .sijedlied 

nssynisH: 

(MKr ."Ordiiiajn:e,s 



Piiwer Sfxxli’nni 

78 and 79) 



ikfisity 
nmininm 10 
mW/MIL 

Austnilia 

2,4(XW.45<1MII>! 

5(MI fiiW 



1 ) In CamKia, mn the band 

2 ) tn Prance/St^ain, only tlic 2 , 445 - 2 , i 83 A/ 2 , 47 S-MHZ liand 

3 ) BRP-tiifcctivdy nidisitcd power 

4) BJItP'liquivalent isotroj^ically radiated ptm^er 

5 ) irrS-Furopean IVieconiniiinicatiori Standard 

(f) MPT-Ministry of B>sts and Teleeornnuinieatiijns (in Japan) 

Table /, hv^fnency imnds aud pauw lemLsfor wirele.ss LANs. 

As we can see, the 2.4 GHz bantl is the only one 
inipleniented worldwide. Hie 802,11 standaal only is concerned 
with the MAC and [ihysical layer parts of wireless networking. For 
those of you unfamiliar w ith die layers of nerworking, In general, 
a complete network stack, or system, is visualized iis having up in 
seven layers. Each layer sits on lop of the other, and receives 
information from the layers alx)ve and below, and passes 
information the s:ime way, The MAC layer siLs on top of one or 
more physic al layer sy.stem.s, as sliown Ix^low in Figure 1. 



TfiePUY 


Figure L The physical layers handle the actual 
connecHom and trammining/receimng of electrical 
or oplicai signals that represent data. 

802.11 Physical Layer 

The physical layer of 802,11 is where the bits hit the wire, 
U is t:onc:erned witJi how traasmis.sion and reception of data 
happens, and liow data is eneroded into the corres|x>nding RF 
signals by the transmitter, and decoded l>y the receiver. There 
are three implementaiions of 802.11; Infrared (IR), Frequency 
Hopping Spread Spet:tnmi (FHSS), and Direct Sequence Spread 
Spectrum (DSSS), The IR iinplenicntation uses infrared light to 
move data, much like a television remote, and die last two are 
radio frequency, (RF) implementations. 

[nfrared - IK 

The IR 802.11 implementation is based on diffuse IR. Rather 
than trying to line up the rmnsmitter and receiver, like a 
television and its remote, an IR-based 802.11 device transmits a 
wideband, or diffuse signal at the ceiling, which reflects the data 
around the area iiniil ii reaches its destination, likewise, 
incoming data is bouncing off die ceiling. While better than 
narrow4>eam IR, this implementation can only be used indoors, 
and rc(|uirc.s the t:ciling t(^ l->e reflective to its wavelength, which 
is in die 850 to 950 nm range. In addition to the ceiling materiai 
requirements, 802.11 IR only has a range of about 10 meters, 
which makes it suitable for a small room, say, such as a work 
area with an IR^enahled printer 

802.11 IR supports 2 data rates, 1Mbps and 2 Mbps. At the 
lMbp.s rate, the data stream is broken into quartets, Fach quartet 
is then encoded into t>ne of sixteen pulses during mcxJulation 
and transmitted. This modulation technique is called 16 Pulse 
Position Modiiiation. At the 2Mbps rate, the modulation is 
.somewhat different, with the data stream being divided into data 
bit pairs, and each pair being modulated into one of 4 pulses. 

Frequency Hopping Spread Spectrum - FHSS 

FUSS systems break up the total bandwidth into narrower 
siib-hands, or channels, and hop from channel to channel 
during tran.smi.ssions. As the signal hops, it sends a packet at 
one frequency, then hop,s to the next channel, and sends 
another packet, and so on. The FHSS signal dwells on each 
band a predetermined amount of time. In the case of 802.11, 
the time is up to 300msec. The hopping sequence is pseudo¬ 
random, (computers can't generate true nmdom sequences, 
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hut iljcy can come very ckxse^ hence tiie Lcrm pseudo 
random.) The sequence anti pa item of the frequency hops are 
parllaliy determined by the geographical location. For 
example: Jafnm specifies three sequences with four patterns, 
Spain S(>ecifies three sequences with nine patterns, France 
specifies 3 sequences with eleven patterns, and the II.S. and 
the resi of Europe use three sequences with 26 patterns. This 
frctgiency’hopping also has the serendipitous side^effect of 
a,ssisting with the collision avcndance frrocess. Since the signal 
is transmiued on any given channel Ftjr a fairly short peritid 
of lime, collisions happen less often. Wiiliin the overall 
bandwidth are a numl^er of I MHz wide channels, the numlxT 
of which depi'mLs on the locality of the sy,sieiTi. In Japan, 
there are 25 of these channels l>erween 2.473Cd-iz and 
2.495GI1Z, whereas in the ILS. there are 79 channels between 
2.402GHz and 2.48GH/, Another impoitant item in the FHSH 
a Igor ii lint is all available channels must lx used before a 
repeal use of a channel, llie PHSS transiiiitLer convetts the 
bitstream from the iranstnitting device to a symbol stream, 
where eacii symbol represents one or more hits, I’he signal is 
uu)dulmed via a Frequency Shift Keying (FSK) metluMj, with 
the specific type of FSK depending on the number of 
modulating frecjuencies desired. If two nujclulalrng 
frequencies are used, then binary FSK is used, and if ftjur 
frequencies are used, then <[uaternary FSK Ls used. This FSK- 
modulated signal is what hops frequencies during the data 
transmissions and receptions. 802.11 FUSS uses a third ty[)e of 


FSK modulation, Gaussian FSK. Finally, although the 
Gaussian FSK used l>y 802.11 FUSS gives higher bit rates in iUs 
channels, it has more sensitivity to noise and otiier jx>or 
conditkms. (Interesting historical tidbit: Spread Spectruin 
using frer|uency hop[>ing was invented in 1940 by actress 
Hedy kuiiarr w'hen she was 26.) 

Direct Sequence Spread Spectrum - DSSS 

The Imal 802.11 physical implemenmttoii is DSSS. Titis is 
the implementation used by Apple, Lucent, Farallon and others 
to create 802J1 wiixilcss networks. DSSS differs frtim KHSS - 
instead of ,SLil>dividing the bandwidth into channels and 
switcliing txtween them, DSSS spreatis the signal acmss the 
entire f>andw'idth. thereby in creasing [jandwidthutiUzaiion. As in 
FHSS, bit St reanus are converted into symbol streams, w'ith eat:h 
sytnlK)! containing one or more bits. The number of bits is 
determined by the mcxlulatam teclmique used, however unlike 
FHSS, DSSS bases its [iiodulation on Phase Shift Keying, or FSK. 
The PSKunodulated symbol stream ts converted to a complex- 
valued signal, which is then fed inkj a spreader chip. The 
spreader chip multiplies tIiLs signal with a psetick)-noise, PN 
signal, railed a chip sequence. 802.11 DSSS bases iLs chip 
sequence on liie eleven-chip Barker se<:|uencc. Tlie Barker 
sequence is just a series of ptjsiiivc and negative values that is 
used to force transitions in the signal. For example, you have a 
pulse lliat kH>ks like Figure 2. 
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Figure 2. Basic Pulse. 

If you mcxlolate that Signal with the following sequence: 
+ l-l+l+M+I+l+l-i-M 


and you invert Lite pulse on every transition, (going high if it was 
low, going low if it was higli), and keeping state if no transitions aie 
allied for, you get a modulated pulse that looks like Figure 3^ 
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1 + 1+1 


1 -1 -1 


ru~i 


JL Samfile Mt/Julaiecl Pulse. 


Alifiough the pulse seems to out of sequence for the last 
liaif of die pulse, die sequence starts over once the lltli key Ls 
used, so although die last key is a -1, and the first key is a +1, 
this is a restart/reset, not a transition. No phase shift occurs until 
die second key, whitih is a “1, and a transition. Spreading die 
signal on diis sequence makes the total CKCUpied bandwidth 
larger, and brings the effective l)andwidth up to It MHz from 1 
MMz, wliile still allowing fallback to 5-5, 2, or 1Mbps if needed. 
Spreading the signal also makes it less susceptible to 
interference, as to completely block the signal, the interference 
must tK:cur across the entire band. However, spreading also 
reduces ovemll transmitted signal power, as the output fxjwer is 
applied over a wider Ixindwidth. Both effects are shown in die 
diagram below, with signal strength as the y-axis, signal 
bandwidth as die x-axis, data in blue, and noise in pink. 



Figure 4. 


Tile outputs of the spreader are then fed into a quadrature 
modulator, and then into die transmiuer front end. B02.11 DSSS 
specifies 2 bitrates: 1Mbps using Binary PSK, BPSK, and 2Mbps 
using Quadrature PSK, QPSK. 


FHSSv, DSSS 

In ccMUparing FHSS and DSSS, we notice tliat DSSS has some 
immediate advantages over FHSS. The first is more robust 
UKxJulation, and greater range, even when Ofierating at lialf the signal 
strengtii of a comparable FHSS system. While the channel-hopping 
behavior of FHSS gives it more overall frequencies, interference 
Ixlwecn adjacent channels timifs the total numlxT of colicxzated FHSS 
systems. However, FHSS does have an advantage over DSSS liecause 
it degrades mote gracefully than DSSS, and can work better under 
worse ccKiditims. Much of diis advantage is due to FHSS not being 
spread oul like DSSS. Sincxj the FRSS signal is concentrated aaoss a 
much narrower bandwidth. iLs amplitude is greater, and FUSS can 
therefore “punch through' interference IxfUer Also, the hopping 
aspect of FHSS assists with frame collision avoidante. These 
advantages aie minimt^^ by the fact that DSSS works reliably at 
much greater distances than FHSS, as ‘^lown in Fig^Ix^ 5 below. 


Trobabjlily uF 
rctlahle link 



in 


Figure % 


Another advantage to DSSS is efficiency. DSSS is able to 
give better performance with fewer access points than FHSS., 
Plus, FHSS reaches a point of diminishing returns much faster 
than DSSS, as shown in Figure 6. 
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\n addition, DSSS can u^ic a higher numbtir of access points 
to get an overall higher aggregated bandwidlii than FIIS5. 
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Figure Z 


Also, in collocated networks, IXSSS gives higher speeds with 
fewer access fx>ints than FUSS. 


802,11 MAC Laykr 

Now iJiat we have taken a look at die physical layer of 802,11, 
let’s inove on to the next part of tltc ^standard, the Medium Atxms 
Control or MAC layer. As a wirele;^ network siamkird, die MAC for 
B02:tl Ls different from the MAC for a wired network snch as 
Etliemet, One example of this is die cx^ietlation that 802J1 Acx:ess 
l^oints (Ai^) are always at,ting as bridges Ix^tween the wined network, 
arxl the wireless network, which is not an assumption in wired 
networks. Pies 802.11 frames have some unique features that assist 
in wireless data traasmLssion and lete'pdon. Fat:h frame lias 
sequence t:omrol and retry fields diat help to minimize interference 
Ixlween suitions. Since lU*' Ls omniditeclional, regardless of which 
AP a jxtrticular end mxle Ls connecting to, its frames lue reteivc-d by 
every AI-^ in range, so die sequence cx>niiDl fields help deal widi this. 
In ainjuneiion with the set^uence r;onirf>l fields, you have the 
type/subtype and duration fields, Utat help ensure reliable 
communiaitioas widi iiidden’ statioas. 'Ihe sequence c^oniKd fields 
alst> work witii die fragmentation fields, which aJlow cadi fiame to 
lx; furtliCT subdivided into smaller fragments if conditions jue bad. 
There are also ToDS andFn^n DS fields that assist in sett up and ase 
of single-channel wiieless liackbcines. 

Carrier Sense Multiple Access/ ColUson Avoidance - 
CSMA/CA 

802.11 uses a MAC scheme that is similar to Ethernet's 
CSMA/CD^ called CSMA/CA. The main dLfferent:e is that 
802T1 practices collision avoidance (CA), as opposed to 
Ftherners collision detection (CD). The reason is that In a 
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discributed wireless network, it is highly iinpraciicril lo 
attempt to detect collisions, because a weak incoming signal 
could either be a frame or noise. The CA in 802J1 is 
designed to avoid collisions entirely, [t reduces the chances 
for a collision during the period of time that has the highest 
probability of a collision, which is the time just after a station 
stops transmitting. At that point, many other stations are 
wailing for access, and will attempt to transmit their data. To 
avoid collisions, 802.11 uses a random back-off arrangement. 
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Figure fi 

As sliown in Figure 8, after the busy medium period, 
there is an Interframe spacing period (IFS), which for 802.11 
is 50p.sec. All devices on the segment must wait for that IRS 
period. Follt>wing the IFS, devices wait an additional random 
numl>er of 20jjscc slots, the number of wliich is determined 
by a binary exponential backt>ff algorithm. If after this time 
has passed, the medium is still free, (no other stations 
transmitting), then the stations can attempt lo transmit, bach 
station uses its own random, (actually pseudorandom) 
amount of wait time, the chance of a collision is reduced. If 
a collision Ls detected, the devices go back into the slot time 
wait mode, until the medium is free. Another difference is in 
the frame acknowledgemenL Although most LAN systems 
require st^me form of frame reception acknf>wledgemeni, the 
wireless nature of 802.11 forces some unique requirements in 
this area. As with other LANs, 802.11 does all its frame 
acknowledgement at the receiving end. However, unlike 
most LANs, 802.11 handles this at the MAC layer, whereas 
other LANs handle this at higher layers. The reason is the 
timing requirements imposed by 802.11. With the IFS lasting 
for only SOpsec, the receiver is required to send an 
acknowledgement within lOpsec, only after verifying the 
CHC for the frame. Hy perforrning all of these functions 
within lOpscc of receiving the frame, the receiver can 
immediately send die aeknowledgement, Ijccause other 
stations are still in the IF8 periiKl, and the medium is dear 
However, these response times preclude handling the 
acknowledgement at a higher layer, hence the MAC layer 
acknowledgement. This speed becomes critical In certain 
topologies, which we will discuss later. A general diagram of 
the acknowledgement, (A("K) l>ehavior is shown below. 


Figure 9- Acknowiedgemwni (ACK) /iebmmr 

At the l>egmning of tlie MAC section, I mentioned 
different 802.11 frame fields, and how some of them are used 
to deal with hidden stations. Hidden stations are somewhai 
unk|ue to wireless networking. Unlike wired networks, 
where every station on a LAN has an almost direct 
connection to any other station on the same LAN, the 
transmit range fimtlalions for wareless can result in two nt>des 
in the same cell that cannot physically see each other. An 
example of this is an AirFort cell within die 150' range of 
each node and AP. Node A is 150* from node B, which is 150* 
from the AP, but from node A. The only way that nodes 
A and B can communicate wttli eacli oUier is through the AP, 
as they are 'hidden' from each other, as shown next. 



In tills case, nodes A and B could easily iransmit at the 
same lime, causing ctillisions. The solution is the 
combination of the To/ITom DS fields and 802JTs use of 
Clear To Send/Ready 'lo Send frames. The To/From DS fields 
tag which way tlie frame is lieaded, unlike Ethernet where 
only the origination and desUnaiion MAC addresses are used. 
In the CTS/RTS system, B sends the Al’ a RT.S frame, 
signaling the AP that B is reatly to transmit a frame. Included 
in this frame is a lime value that represents the amount of 
time Lakes R to transmit the data frame. The field that holds 
this data is ilie length field. 
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The BSA estimates that over 40% of new applications ins tailed 
yearly are pirated. Disk swapping and copying aren’t the only prob¬ 
lems developers need to combat. E-commerce piracy is now surpass¬ 
ing traditional forms of'software piracy, raising developer revenue losses 
to an all-time high.^ 

To prevent software piracy and track those who attempt it, New Wave Software, Inc. 
has developed SPr”- Software Piracy Intervention. SPl adds a prot^tive layer 
to your program that allows only those end-users who legitimately pur¬ 
chase? your software to install it. Once a legal product is installed, SPI 
prevents illegal copies of the installed product from running on any other 
computer. No matter how many copies of your program get distributed 
illegally, only the valid pun!haser can install and run your produert. 

Bt?si of all, you don’t have to track product installs. SPI will run product 
installation reports that can be accessed daily, weekly or monthly, what¬ 
ever your sales volume dictates. 

SPI protects your software product with a password-protected archive. When the 
end-user installs your product, the SPI archive is subjected to a scries 
of validation checks. During validation, the end-user s IP information 
is recorded. If your product was mdet?d pirated, this information can be 
used to proset:ute the thief. SPI can also remotely disable stolen pre¬ 
packaged software, rendering the stolen products useless to both the 
thief and their purt;hasers. For just pennies a copy, you can protect all 
your products and significantly increase your revenue without increasing 
prodiuttion costs. 
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SPi i$ cross-plattorm and works seamlessly with any software application or file 
type- Products protected with SPI can be distributed using any type of 
rewritable media, CD-ROM/DVD or over the Internet. SPFs upgraded 
features include resource encryption and key file encryption to protect 
against file tampering, 3 demo modes, online product registration and 
6 general registers that can be used to store critical memory allocation 
values , as counters, as pointers, or anything else that your creative 
developers can think of. 

Start protecting your products now. SPI prevents costly software piracy 
I with every product install. Call S00-92Q-9283 to order your SPI software 
protection today For more inf[>rmation on SPI and software protection, 
visit our web site at www.nwspi.com. 
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Signal Field 



One of the oilier benefits of RTS/CTS^ besides avoiding 
congestion, is tfuit che 802.11 implementation incurs a relatively 
low overlicad. In the example l)clow, even in a *pure' RWCfS 
environment, the throughput is only reduced about 13% over an 
cnvtR>nment with no RTS/CTS. 


* Rale icHficniioii 

- hOA iMb.'s 

- hl 4 2M\>itXf^K 

- Other valuta loteived for futtm? use (100 IdVs qttutilluesl 

Figure II. 

Node B then goes into a wail mode. As stxjn as the IFS and 
backoff period passes, the AP broadcasts a Cl^ frame fur B, hut 
received by all stations in using the AR Tliis CTS frame has the 
same lime value that was in I he In'S frame. All statkms that 
aren't B receiving this frame immediately cease transmitting for 
the amount of time in ihe Cl'S frame. Once B receives the CTS 
frame, it begins transmitting its data frame. The First diagram 
below iilusirates this process in a basic way, anti the one 
following s1k)ws a more detailed view of the Ifl'S/CTS structure 
in conjunction witli the CSMA/CD backoff iK‘havior 
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figure 14. 


A says to B: Tm gdng 10 send yoo data, and B teke 5 minutos' 

B says 'everybody quiet for s minules!' 

C hears this aiso. so he wjfl not transmit while A is transmitting. When A stops 
transmitting C knows that the air is free 

The benefit for the wireless LAM user is that the RTS/CTS will make the systerr 
more robust (agairist M messages) and ihcre^s the performance of the 



figure 12. 



* Duration field in RTS and CTS frames distribute Medium 
Resofvation information which Is stored in a MiAlfocetfOfi 

• Defer on either NAV or XCA" Indicating Medfum 6tisy. 

• Use of RTS / CTS Is optional but must be Implemented. 

* Use is controlled by a RrS.Thrssftold parameter per station. 

- To fimh ovArhead for short frames. 

Figure /JL 


The low impact of RTS/CTS on throughput, along with its 
collision reduaion capabilities, make it a very attractive feature 
to look for in an 802.11 prfiduct, allliough the RFS/CTS feature 
i.s opiional under 802.11, and can be removed for cost savings. 

MliscelUineous 802J1 MAC features 

Anmher feature of the 802,11 MAC is fragmentation, which 
is a lechnique for dealing with p<K>r transmission crinditions. 
Unlike wired LANs, 802.11 networks must deal witli things like 
interference from nearliy antenna, or mioowave sources such as 
moliile television transmt.ssion units. To overcome interference, 
802.11 allows a frame to be fragmented, or split into smaller 
chunks, (See Figure 15.) 



Since fragments are smaller, ihey allow lx)ili end ncxies and 
APs to recover more quickly fwm Ixidi transmitting and reexaving 
them. In addition, tltc smaller fragment size means that emm in 
fragmeni exchange liave a lower overall effect on data throughput. 
Ttiis is also assi,sted by the fact tliat the frame is not considered to 
tye sent until all fragments have lieen sent and ACK'd. Thus tlie 
sender of the fragments has control of the medium for that period 
of time. Finally, in the case of interference such as microwaves, the 
interferenc'e icself is 'bursty', so the smaller fragment size meaas tlie 
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fragments handle tliis type of Inierference l:>ener 802.11 requires 
fragmentation support on receivers, but it Ls optional on 
imnsmitters. 802.11 also allows for dynamic fragmentation, to suit 
the nature of the interference encouniemd. By allowing for itie 
possibility of full-time fragmentation, the vendor ean build its 
receiver cheaper, by avoiding the cost of adding enhanced 
fragmentation support, I lowever, since fragmentation means more 
transmLssioas, the overhead is higher, and can reduce iliroughput. 

Roaming is another imix>rtant part of 802. Ih Roaming is not 
a requirement, but it Is an important feature to corporate 802dl 
customers, ll is usually left out of 802dl devices, to reduce cost, 
as in Apjde’s 10-User AirPort fx>d, (which is designed for home 
and school use, where roaming is not necessary), i One major 
advantage to rtraming is for laptop users going from meeting to 
meeting in different areas of a floor or building. In a wired setup, 
tile user must either power off, or sleep the laptop, and 
disconnect the network wire. They must then reverse* this 
protress at tlieir destination,. In 802.11 roaming, the laptop is put 
to sleep, carried to its destination, and woken back up, 7'he 
802.11 devicre in die laptop conneerts to the neare.st AP, and 
neinserts iLscIf on the network. Tlie actual procedure that allows 
diis to happen is not much more complicated. 

In an 802.11 network, each AP sends out regular beat.xras, 
(around every 100msec) to all end nodes in range. ln('ludc-d in tlx? 
beacon arc such data as a current timestamp, (for any needal 
synchronization purposes), a map of current traffre, and supported 
data rates. \ Ipon receiving this beacx>n, each end node can judge the 
clarity and strength of the signal and use it lo determine whether or 
not to attempt a connctiticm to the AP, or if anotlier AP^ (if multiple 
APs are being used) would be a lx:tler choice. An end ruxle can 
send out a Ijeacoo of its own, or a probe request mc:ssage to any 
APs in range, which then respond with a proix: itspoase message, 
or solkited beaa>n. In either case, the end node, not die AF, 
determines the communk^atioas quality (CQ) of the signal from the 
AP, and uses the CQ level to detennine which AI’ would make the 
best conneakm. If die CQ of a conneticd AP signal dn>pis below a 
certain ihashold, (which is determined by a number of factors, 
including vendor design, asage, speed, etc.), due to either 
interference, outage, or our roaming laptop above, the end node 
actively scaiclies for a new AP OrKc a new AP is found, die end 
ntxlc moves into a handover state, and reasstxiiates with die new 
Al^. The new AP communicates with both die end node, and the end 
node’s pa^vious AP to le-establish die end node's place on the 
network. The APs use an inter-access point proUxxJ lo inform each 
odier of handovers and roaming end ntxlcs. Tliis allows 802.11 
networks dial use MAC addiess audicntication to hand over that 
information from the old A? to the new AP, thert^by allowing die 
network to prevent unaudiorized roaming, (via the use of MAC 
address/passwoid tables, etc.). Aldiougli a way to easily move a 
laptop from room to room, roaming ts also handy for PDAs and 
Ollier handheld devices. For example, a 802.11 handheld 
computeri7jt.d cliait with roaming would allow medical personnel to 
easily move from patient to patient, without having lo re-connea if 
tliey moved out of an AP’s range. As noted earlier, Apple’s tO-iiser 
AirPort Pod dix-sn’t support roaming, aithougli Apple rtx.endy 


announced a 40-50 u.ser PcxJ that would supfxm retiming. 'Ihe 
roaming features of 802.11 are spetHficjilly supported by aimpanies 
such as l.ut:ent, Digital Ocean, ami Aironet, (who helped developed 
the InlerAccess Point l^roKxxil), Apple, IBM, and fidler companies. 
Tlus helps companies tliinking abf>ur building an 802.11 system 
avoid being tied to one vendor for roaming support, and Ls ciidcai 
in 802. ITs acceptance. 

Finally, tlie 802.11 MAC lias certain security feairtiies, to help 
prcveni unauthorized 'guests' on a wiieless network. First of all, 
DSSS Itself makes snooping difllcull. Tlie cbta is encxxJcxJ and 
spread across an entire Imid, any snooper must liave the Ibchip 
Barker code used for a given IAN, and has to l^e able to le^ 
assemble die signal, which ret|uiros diem to cover die entim 
portion of die 2.4 GHz ISM Ixuid Ix’ing used. Also, 802.11 allows 
for data transfers to lx encrypted using a 40-bit RCA key. Although 
not the best key length available, die 4tkbit key was cliasen 
becxiLLse of the complete bek of U.S. export lestriaioas on 
encryption technology liased on tfuit key-lcngdc Regardless of the 
key length, between the DSSS characteristics and the RCA key 
encryption, 802J1 signals arc at least as secure as data traveling 
over a wired network, witli die same encryption. 

Topologies 

802.11 supports diau Imsic tojxilogy jxilxmcs, Indetxndeni 
Basic Service Set, CIBSS), Ibsic Service Set, (liSS), Ijctended Service 
Set, (ESS). IBSS is an ad-hoc ptvr to peer topology. Ttietc is no 
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cleciioiicd AP acting as a a-ntral point, and Ls [iniitcd in size and 
scope. IBSS w<Hild be used in a situation where a iLinporary 
a>nneaion w;is axjuiietl between a siuiilJ number of ainifxilcpi. 
BSS is tfie more a>ninion topology used for 8()2.11 networking. This 
is also tile ajmmon anangemcnt for a .single cell within a larger 
network. BSS uses a dedicated AF that is tlie logical server for llie 
cell or wireless LAN (WLAN). All node communicaiions thiuugli 
the flow iliroLigh the AP^ whicii can he amneaed lo a wired 
network. In tilts case, the Al-^ acts as a bridge for the wired to 
wireless networks, ESS is the final, ;ind latgesl topology of 802.11. 
An ESS topokjgy aiasLsts of multiple BSS cells conncaetl by a wiied 
or wireless tecklx)ne. Tlie cells citn citlier lx* on the same channel 
or multiple channels. If the cells are on the same channel, then the 
overall Ixindwidtli is shared by all cells on the Ixicklxme, If multiple 
c*hannels are used, then the aggregate liandwidih Is Ixxxstc'd. In the 
case of an ESS to]X)logy, 802,11 lias certain speciftc features that 
incR'asc^ its usehilness as a Ixickbone technology. Normally, for ;in 
AF to act as a txi< kbone node, it wtnikl need a separate iransmitrer 
for each cell it was liridgtng. 1his would c|uickiy ntike wireless 
backlx)ne.s too expensive to use, 802.11 dreumvents this by 
allowing single-c’liannel frame forwaaling. If the AP receives a fotme 
for 3 station it can't see, it forwards tlie framt^ to any other Alls it can 
see iJiat aren't the one tliai .scot it die frame. Tliis is an econoniiatl 
solution willi good perfomnmee c'haracTeristic^s, allliough like any 
single ciumnel l>aeklx)ne, overall Ixindwidili tan lie a limiling factor. 

Power Management Support 

Since die majority of wireless IAN u.sers are nxihilc devices, 
802.11 includes s|x.Tiftt:atioas for [xiwer muruigemenl su[iix>rt, 
Wlien a station traasmils a frame, that frame conratas n power 
management, PM l>ii. lliat liit indit:ates the sUition's aim^nr power 
management mode. If the PM = PS, dien the .station is in power 
saving mexie, and if die* PM "" A, ihai die station i.s in active mode. 
In a network u.sing acress poinis, such as the Airlfon P(k 1, the access 
p(.)ints uses the status of the stations to delemiine trallic managetiic*nt 
for die stations, tf die suition is in PS mode, dien ilie access fxjinl 
will IxilTcr any messages for diat .stadon. On a tegular txisis, for 
example, every lOOmset', the aceess fx>int .sends out a Ix^^acon framer. 
TIiLs frame conUiins tfie addresses of the stalion(s) for which die 
atress jxjini is buffering messages. The stations axiK- out of DOZE 
mode, (a,k,a, sleep) on a regular Ixasis, Insed on die Ix-ac^on frame 
timing, 'Ihe ,station(s) read the Ix^acoo frame, and chc*c'k for liufTered 
messiiges. If the frame iiidUrates that the stadon lias waiting 
messages, die .station stays in die AWAKE mexie, and pedLs die access 
fxiint for Its buffeted mcissages, at whkJi dme thc^ messages am 
.sent. Tliis is how jxiwer management works for unicast, or station 
spectfie tiiessages. 

In the case of mullic^ist messages, or network-wide mcssiiges, 
diere Is a different prcxicxiure. For muldcasl messages, tiieie Ls a 
cliange to the bt‘acx>n frame. At a paxleieniiined multiple of the 
ttntt^ast beacon transmission time, anodier field in the Ixracon frame 
Ls used to indicate duit diere are multicast messages being buffeted. 
Once die muttica.st-lx?a€on bis lieen received, the multiaist 
messages are irnmcNiliately ,'^at. When a .station receives a Ixtacon 
frame showing multicast messages being Ixiffered, it stays in AWAKE 


mexie to receive the multicast nxfssages. An extimple of a queuing 
structure used by an 802J1 access point, the WaveLAN from Lucent 
is shown in the diagram below. All statioas that aaai't B rec'etving 
this frame imtiiedialely halt all transniLssion. 



PS P0Wt?f %T#VK| 

HI - Madio 

WMftC Wir ntetiuin dcct.-u control 

figure l(k *fhi^ H02.i I Rmer Mewagemen! Scheme 
for an Access Point. 

Tlie frame* transfer liltKk is ihe only section that works 
directly with die HF section. Tlic frame transfer has two input 
queues, normal transmii and priority transmit. 'Ihe priority 
queue is uscxl to schedule internal management and control 
protocol frames, ami the normal queue is used for data frames 
coming from higlicr layers in die networking stac’k, such as user- 
generated data. HicTe is a single multicast queue for all stations 
connecting to tliis access point, and an individual unicast c]ueue 
ftjr each station us well. When polled by a station, the message 
at the head of that stations unkrast queue is jiassed direedy to 
frame tran.sfer tor highe.st priority transmission. When a station 
dial was in PS mode, (IW^PS), sends a message, (not a poll), lo 
die access point that shows it is now in A mode, (PM=A), all of 
the buffered unicast messages are forwarded to the normal 
transmit queue. When a .station that was in ac:tive mocle sends a 
message to the access point indicating that it is now asleep, 
(PM=PS), all messages in the normal transmit queue are moved 
to that stations unic'ast sleep queue. 

The diagram lK.hm^ show.s a block diagram of two fxiwer 
managciTieni schemes, both the '.siantLiRf 802.11 scheme, and 
an ‘enhanced’ scheme develofx'd for die WaveLAN. 
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Figure IZ State Diagram for Two Different 
Power Management Schemes. 


'I'he end node stations, when not actually transmitting, 
switch between the DOZE and listening for a beacon’ state, llie 
station's timer wakes the station up ju.st prior to the Ixracon 
frame. If there are no messages bufTered, the station immediately 
drops back into DOZE mode. This cycle, used in l)oih the 802.11 
'standard' .scheme, (shown in blue and light gray) and the 
WaveLAN ‘enlianced' scheme, (shown in blue and dark gray) 
allows the station to spend up to 99% of its time in DOZE mode. 

In the standard scheme, when buffered messages are 
detected, die station stays AWAKE, and either waits for multica.st 
messages, or actively polls the access fxiini for its messages. 
Once all messages are received, it then goes back to DOZE 
mode, Tlie enhanced scheme adds a 'holckiver' state tlial is used 
when a iraasmi.ssion is detected, or buffered messages are 
present. This holdover state temporarily switches the station 
from DOZE to ACIWE mode, and sets (PM=A). The access point 
then traasmiLs all buffered messages, and halts unicast queuing 
for that station. The station stays active until the holdover period, 
(usually .5 to 3 seconds) has passed with no transmit or receive 
activity occurring for that station, Tlie advantages to this 
holdover state are due to the fact that iiiosl LAN activity is bursty. 
Bursty is, periods of no traffic followed by periods of heavy 
traffic. By ken^ping the station in the active state for the holdover 
period, the fonnation of queues is avoided. Also, the message 
polling system used to get buffered messages is rather 
inefficient. Finally, if the station has been asleep for awhile, it is 
handy to keep the station awake long enough for any 
applications on the station to tend to their own network-related 
housekeeping, and to receive any traffic related to that 
housekeeping. As an example of the differences in power usage, 
for the WaveLAN, die trdn.smit mode draws 300mA, receive 
mode draws 250niA, and DOZE mode draws 9mA, so the p<jwer 
savings can be considerable. 

802,11 Devices 

Now that we have covered most of the 802.11 specification, 
let us look at some of the devices that actually ase 802.1 L The 
WaveLAN is viewed in more detail than the others, since there is 
more detail available. In general, most of the non-device spetafic 
features of the WaveLAN, will apply to all 802.11 devices. 


History 

Tlie WaveLAN was introduced by NCR in 1991 for wireless 
networking. The WaveLAN was designed to operate in the 
915MHz band, and was originally produced as an ISA (Industry 
Set Architecture) card for desktop PCs. During ilie product's 
lifecycle, other t:ards were prtxlueed for other buses, and 
WaveLAN was upgraded to operate in tlie 2.4GHZ band. The 
WaveLAN was improved with regard to operating systems 
supported, card size, power consumption and software suppor. 
The heart of tlie card, namely the NCR digital signal processing 
(D.SP) application specific: integrated circuit (ASIC) and Intel 
Ethernet controller were not. The WaveLAN is not tcdinically an 
802.11 device, as it preceded the standard, but many of its 
features were used by the 802.11 committee. 

Now 

I'he current version of the WaveLAN has made considerable 
improvements on the base 802.11 standard, wliile retaining full 
compatibility. It allows for l>il rales in the Ithl 1Mbps range, 
while being able to decrease its speed, or 'fall back’ when 
communicating with a different 802,11 device that can only mn 
at 1 or 2Mbps, 'iTiis is because the training preamblc/hc^ader of 
the transmissicjn, looks the same regardless of bit rate. Tlie 
preamble takes 200|i.sc-c to send/receive, and Ls modulated at a 
bit rate of 1Mbps. The data portion of the transmi.s.sion, which 
can take longer to process, (maximum data size is 2.3KB/frame), 
can be sent different speeds, up to tlie maximum speed of the 
device. Both devices can negotiaie the proper speed Ix^cause the 
preamble is recognizable by any deviere that is 802.11-compliant. 
(This is a more complicated version of the way two modems 
handshake with each other to determine the best 
conimunications speed.) 

In standard DSSS, the 11-chip Barker c<xle is used to carry 
1 or 2 bits of data per pulse. I'his gives us the standard 1 or 
2Mbps speeds on standard 802,11 devices, 'fhis signal, or lobe is 
one chip wide, with the 10 additional chip positions in tlie 
.symlxjl period creating sidelolies that are M times .smaller than 
the main lobe. (Note: In any RF transmission, die main signal is 
the main lolx:. Other, weaker versions of that lobe transmiticxl, 
are called sideii>lx.^s. This is noticeable when you drive by a 
radio station transmitter, and hear a station interfering with other 
stations dial operate close to that station’s frequency, Tlie 
interference is caused by, among other things, the sidefobes of 
the signal, which are ntjrmally to weak to ix.^ picked up. 
SideIo!x:s are also used to help jam radar.) Each of the other 
chips in tlie Barker sequence can also lx: modulated, in addition 
to the normai QPSK mtxlulaiion, Lucent discovered a way to use 
lhi.s additional modulatiori io increase the number of l)iLs per 
symbol fa>m 1 or 2 to 10 or II, which Ls being used in the 802.11 
to enhance the existing throughput rates. Tliis gives us, (and the 
AirPort), Ethernet speeds without wires. There are some 
downsides to this, namely that widi higher performance, signal- 
to-noise, s/n, ratias become more of a concern, with the higher 
speed transsmissions requiring s/n's of 6dB. 
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llie Wavel^AN card ius a numlier of physical traits, which 
are common to all 802.11 PCMCIA mrd devices, so we will use 
IT as an example for other 802.11 devices. Note: The diagrams 
and chipset names were as of late 1997, st> mmc details may 
fiave changetl, bill tlie basic structure is the same kxlay. 
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'fhe first section is the antenna, used for transmitting and 
receiving. The card uses 2 l-shapcd inverted’F antennas. 
These antennae are spaced between .25 and .5 of a 
wavelength apart, which gives good separation. 1'he 
antennae act as a “eaky'' 2,45GHZ resonator, +/- lOOMHz, 
wliieh aids in the function of ilie antenna. Phis, the shape of 
the antennae ensures that it is no bigger, overall, than .125 of 
a wavelength, which helps to make ii very omnidirectionaL 
Tills characteristic allows the WaveLAN to avoid the need for 
a line-oksite recjuiremcnt in its operation, (NOTE: Antenmt 
are cut/sixed to specific multiples of the wavelength of the 
signals it transmits or receives. By using even multiples or 
fractions of the wavelengdi, the antenna can be made much 
smaller than the full wavelength, which, in the case of 
shortwave, low frequency signals, can be hundreds of 
tneters. Wavelength and frequency are inversely related, with 
the wavelength going down in size as the frequency becomes 
higher.) The next section is the RF front-end. This performs 
up/down conversions of ouigoing/incoming signals based on 
a 352MHz intermediate frequency (IF). This section also 
includes a low-nuise amplifier. (NOTE: Up/down conversion 
is done to save space and components. At higher 
frequencies, if you want one unit to operate across multiple 
frequencies, wliich receives signals from the low MHz range 
into the 30+ GHz range, you must either use multiple 
antenna and HF sections, one per frequency, OR, you use a 
wider range antenna and a mixer, set at a known 
intermediate frequency, such as the 11 GHz TF in radar 
detectors. 'Phis mixer separates the incoming signals from the 
llGHz TF, and allows signal discnmination and analysis to be 
handled behind the antenna, saving space and weight, Tlits 
mixer approach also uses less power than the multiple 
antenna/RF section method.) 

Behind the KF front-end is the IF transceiver. This 
.section handles TF-basel>and up/down conversions via a 


(de)modulator chip derived from a Global Systems for 
Mobile Communications, (GSM) chip. Following along the 
component chain, we next have the DSP ASIC, named 
Theseus. This chip handles tlie analog/digital and vice-versa 
conversions between symbol streams and RF signals. 'I'his 
DSP is required because the speeds at which the WaveLAN 
runs require about 2000 multi ply-add operations/psec, which 
is too much for standard DSP chips. This chip is the main 
engine of the WaveLAN card, and has 2 digital to analog 
converters and 2 analog to digital converters, all of which run 
at 22MIIZ with a 6-bit digital representation, 

'Ihe final ASIC in this line is the Wireless MAC (WMAC), 
protocol A5IC, called Hermes, ThLs cliip handles the 802T1 frame 
traasmit and receive funtnioas, as well as power management, 
Automatic Kate Fallf^ack (ARF), Multi-channel roaming and 
handover management, Ihe other two hardware componenLs are 
the flash ROM and the RAM chips, which handle configuration 
information and message buffers respectively. 

Finally, the WaveLAN is a scalable system, which can 
contain as many, or as few, access points and their cells as is 
needed. The powt;r level of the WaveLAN transmitter is 
15dBm, CJr 30mW. As a station communicates with an end 
node, tlic signal levels increase and decrease as the station 
moves closer to, or further from, the access point. Each access 
point has a configurable carrier detect threshold (CD'F). Each 
access point usually employs 2 levels of CDT in an inner / 
outer cell configuration. Within the smaller inner cell, the 
CDT is higher, and faster communication rates, up to 11 Mbps 
can (xrcur The larger outer cell has a lower COT, and 
communication speeds are limited to 2 or 1 Mbps, If the 
signal level falls below the outer cell's CDT, the station cannot 
communicate with that access point, and must either connect 
to another point, or neiwt>rk communication is interrupted. 
By configuring the CDT levels, more access points can be 
located closer together, and share die same channels. Sharing 
is assisted by another configurable thre.shold, the defer 
ihreshold COT). The DT is lower than the CDT, as its purpose 
is different. When an access point detects a signal above the 
DT level, the station holds up a pending transmission. This 
liehavior is called deferral. Within the deferral radius, which 
coincides with die inner cell, all ,stations defer to each other 
as part of the 802,11 CSMA/CA rules and behaviors. Outside 
of the deferral radius, in the outer cell, deferral is not 
guaranteed, so the RTS/Cl'S rule.s are u,scd to avoid collisions. 
The total cell area is called the Basic Coverage Area, or BCA. 
The part of the cell with guaranteed coverage is called the 
Shared Coverage Area, or SCA. Ideally, we want the SCA and 
BCA to be identical. The sizing of the SCA and BCA are 
important in a multiple access point/cell network. If many 
cells are used, then the SCA and BCA areas can be equal, as 
the access points are close enougii together to allow 
handover to happen more often, keeping the station in the 
highef'Speed SCA areas at all times, ff for any reason fewer 
ceils are available, then the BCA is larger than the SCA, and 
only die areas outside the SCA in the cells overlap. This is a 
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benefit, as fewer access points are needed, but can be a 
hindrance, as connection speeds rise and fall as a station 
roams throughout the network. To allow smooth transition 
between the high and low-speed areas of the cell or cells, an 
automatic rate fallback, or ARF, is used, llie MF allows the 
WaveLAN to decrease its speed as it moves farther from the 
access point. Tlie station to remains connected for greater 
distances instead of only allowing the highest speeds. In 
addition, the ARF allows the stations and access points to 
communicate if the signal quality degrades for some reason, 
allowing for reliable communication in more adverse 
conditions. The ARF is relatively simple in function. It keeps 
track of the ratio of successfully transmitted frames to 
unsuccessful transmissions. As the number of unsuccessful 
transmissions increases, it slows down the bit rate until the 
ratio is at proper levels. When the ratio improves, it increases 
the bit rate back to the norma! maximum. 

farallon Skyline 

Tlie second 802,11 product found was SkyLINE by 
Farallon. Similar to the WaveLAN, SkyLINF is a DSSS device that 
operates in the 2,4GH2 spectrum, allows for easy wireless 
networking by a variety of devices. However, even though l>oth 
are 802.11-compliant, there are some important differences. 
SkyLINE operates on a more standjird 802.11 scheme, with top 
speeds limited to 2MI>ps, which gives tlie SkyLINE a ,sUUed 
range of up to 1000ft outside, and 300ft indoors. 

The SkyLINE is based on the Harris PRISM chip set, and 
comes with software for both the Mac OS and Window.s. The 
user can set various configurations for connecting to access 
points, or other end nodes in an ad-hoc setup. 
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Figure 19^ 

As you can see in Figure 19, the st)ftware controls the 
modes of access and addressing, as well as keeping track of the 
signal strength of the current connection. Although not an 
interesting statistic, die strength meter does give you the ability 
to tell if you are attempting to connect to an access point that 
ha.s a goexi enough signal to maintain a reliable connection. 

The SkyLINE card is a standard PCMCIA card. Ilie 
antenna and status lights protrude from the end of the 
laptc^p, when the card is inserted. 'I’here have been some 


complaints when comparing the AiiPort card in the iBook to 
systems such as the SkyLINE regarding the protruding 
antenna in oon-AirPort devices. The: reason for this is simple. 
In the iBook, and tlie high-end G4s, the antenna is built into 
the case, so the card can be completely internal to the 
computer. With other computers, the antenna is not a part of 
the structure, but is part of the 802.11 card, hence, the 
protruding antenna, as seen below. 



Figure 20 , 


The antenna i.s an internal dipole, similar to the WaveLAN, 
(One thing that you will notice about products tliat have 
similar requirements, is that the constniction does not tend to 
lx.‘ terribly different.) Transmii and receive power levels are 
also similar to liic WaveLAN, {2.1w Transmitted, and 1.6w 
Received.) Tlie SkyLINE also fallows similar power saving 
methods, as most of these are diclatecl by the 802.11 standard, 
and the rec^uirement.s of a PCMCIA t:ard. Farallon has stated 
that tests show the SkyLINE to be operable witli Lite AirPort 
and other 802.11 devices, such as the WaveLAN. 'J'he SkyLINE 
and AirPort cards can easily connect to an AirPort pod. 

The Skyline operates on 14 channels within the 2.4Ghz 
band, and uses the channels in a number of ways. When 
connecting to an access point, it goes through the channels 
until it finds a point with enough signal strength for a reliable 
connection. By splitting the band into channels, the SkyLINE 
can avoid problems with end nodes and access points 
interfering with each other. Also, it use.s the channels to 
search for an access point if the one its currently connected 
to should fail, or loose strength. Ihis is similar to the 
WaveLAN’s methodology for roaming and reacquisition after 
signal loss. Finally, if a laptop or other portable with a 
SkyLINE card is put to sleep, upon awakening, the SkyLINE 
card automatically atiempts to reconnect to the network. 

Apple AirPort 

The final 802.11 device in our examination Is Apple 
Computer’s AirPort. The AirPort consists of 2 parts: Tlie end 
node device, such as the AirPort cards in the iBook and G4, 
and AirPort Base Station, or Pod. One of the obviou.s 
differences between the AirPort card and otlier 802.11 end 
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node devices is the lack of an antenna. Apple has built the 
antenna into the case of the iBook, and the high-end G4s. By 
doing this, Apple is able to make the AirPorl card completely 
internal, so as not to mar die lines of dieir newest computers. 
It reduces the cost of the card, because the antenna cost is a 
part of the computer cost, and not the AirPorl cost. This design 
also allows more room, so they can use a bigger antenna 
which gets better reception from a weaker signal than the .125 
wavelength antenna used in devices such as the Wave LAN. 

Apple has announced two access poioLs as well. The first 
model is the Pod^ shown at the MacWorld Expo '99 in New 
York, supports ten users, with a range of 150 feet. The Pod 
has two wired inputs, one 56K modem pon, and one 
lO/lOOMbps Ethernet port. Simple math gives the reason for 
Apple stating a lO-user limit on the Pod: With a maximum 
bandwiddi of 100Mbps, 10 users is the max that could get the 
11Mbps advertised speed from their AirPort cards. In reality, 
you can connect more users to a Pod, but the bandwidth 
drops in proportitm to the number connected. The range 
numbers reflect tins as well, 150 feet is the maximum reliable 
range for an 11Mbps connection. As you go farther from the 
Pod, your speed drops until you either disconnect, or 
connect to a new Pod. In addition, the wired connection is 
an either / or proposition. You cant have both running 
simultaneously. Concurrent connections would require the 
Pod to act as a router, and driven the cost up along with that 
functionality. Finally, the 10-user pod does not support 
roaming. Considering the target marker for this modeh this is 
not surprising. Most home and K-12 educational users don't 
need roaming, as one pod can easily cover most homes 
completely. In a K-12 setting, the students are disconnected 
l>eLween classes, so roaming is not an issue there either. 
Also, by eliminating the roaming feature, Apple was able to 
keep the Pod cost down to the $300 range. Apple recently 
announced a 40-50 user Base Station that dcH:s support 
roaming, but no details have t>een released as yet. 

802.11 Competitors 

At present, there arc only about two well-known 
competitors to 802.11 in the wireless networking world. (I 
know I am leaving out a ho.st of vertical market systems, but 
I am limiting this to non-proprietary systems, so as to 
compare similar systems.) 

IrDA 

The first and better-known system is IrDA, or InfraRed 
Data Association. While IrDA is best known as a laptop to 
printer connection, the IrLAN specification does allow for a 
wireless infrared IAN. IrLAN is designed to run at speeds of 
up to 4Mbps, and is a fairly cheap hardware specification. 
Even with good speed, an<l cheap hardware, IR in general 
has limitations that make it unsuitable for general-purpose 
networks. One of the problems is that walls^ people, or 


sources of heal, such as the Sun, stop JR. So right away, 
IrLAN is pretty much indoor only. Also, since IR cannot go 
through walls, to use it in an office situation, the only way to 
avoid having everything be in a direct line of site, the IR 
signal must be reflected somehow. This involves ensuring the 
ceilings, and sometimes the walls of a building are made of 
an lR-rcflec:live material. Reflective materials are expensive 
and aesthetically unappealing, as it rather limits wall 
treatments and paint colors. Finally, the range on IR tends to 
peter out at about 10 meters, so the number of APs required 
to cover a given area is larger than for 802.11. This is not to 
say that IrLAN is not useful. In a warehouse situation, or an 
a.ssembly situation, it c:an be a cheap alternative to wiring 
computers together. Also, since virtually every shipping 
laptop has an IK port, in a college lab situation, it is an easy 
way to allow students to print with their own laptops, as 
opposed to using email or a sneakernet to get the files to a 
computer on the school network. In specialized situation, 
IrDA can be useful, but speed, range and other limitations 
relegate it to a niche networking techno logy. 

Bluetooth 

The other currently popular standard is Bluetooth. 
Sponsored by a computer and telephony consortium of 
companies such as IBM, Nokia, Intel, and Ericcson. Bluetooth 
has been getting a lot of press lately as a new networking 
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standard. Bluetooth operates in the same ISM band as 802.lt, 
blit it is designed around a much smaller scale than 802.11. 
Bluetoodi is designed to give vendors of cell phones, PDAs, 
handheld computers, etc, a way to create plconets and 
connect these devices easily. Bluetooth has a range of 10 
meters noniiaily; lOO meters with amplifying repeaters. The 
maximum data rate is IMhps, although 720Kbps is normal. 
Due to these range and speed limits, obviously Bluetooth is 
not a true competitor for 802.11, or Ethernet. So what space 
does Bluetooth occupy? Interestingly enough, Bluetooth 
seems to be more of a RF compeittor to IrDA. Its a low-cost 
way to create w ireless connections between devices that don't 
have high data or range requirements, such as keyboards, 
joysticks, cellular modems, etc. An example is a wireless 
joystick iLsed to play a flight simulator that is using an 802.11 
connection tc^ share a calde modem or D8L line. Another valid 
comparison wtmld be USB vs. FireWire, with Bluetooth filling 
the USB role. Bluetooth is very attractive to cell phone 
manufacturers and PDA vendors, as ihose devices lake on 
more of each other's feaaires. Since BluetiKith is an RF 
specification, it carries all the advantages of RF, such as 
omnidirectional broadcasting. Another example is two 
Bluetooth-enabled PDAs communicating without being 
pointed at each other as IK ports require. Bluetooth can also 
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enable short'range cell phone communications without 
liaving lo filiicc a traditional plume call You can look al ilic 
list of Bluetooth phones in range, and talk to one, just like a 
set of walkie-talkies. Another use could be easier printing 
from PDA.s, cell phones, or even Rliietoolh-enabled pagers. In 
conclusion, Bluetooth looks to be a good, smaller companion 
to 802.11, instead of a competitor 

Conclusion 

Both the AirPort and the 802.11 specification are poised 
to make an enormous impact on the conipuler world, Apple 
is leading the way to increased usefulness of networks, and 
the number of netwemked computers overall by introducing 
a high-speed, easy to use. inexpensive, standardized wireless 
networking system,. Especially in the home niarket, where 
many users are reluctant to run wires, or buy hubs, etc., the 
ability to wire your home in a few steps, at a more than 
reasonable pric:e should create an marked upswing in the 
number of networked homes. In addition, by ensuring that 
the AirPort is an 802dl-compliant system, Apple avoids 
proprietary hardware problems, and which makes them an 
altraaive vendor for coqxjrate wireless solutions. Also, the 
publicity generated by the iBook and the AirPort system will 
create a swell of <leniand for these systems, resulting in sales 
for all 802.11 vendors. Increased sales help promote the 
802.11 standard itself, and drive upgrades to the speed and 
capability of tlie standard at a faster rate. 
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InstallAnywhere 


A Truly MuUi-Plai/orm 
Deployment Solution 


'I'his article is set-up to provide yoti 
with an introduction to histalL^ywhere- 
and lead you on a tour of tlie product-s^ 
main functionality. If yoifd like to 
the Kinctionality in action as you i:ead 
you can download fully functional trial; 
versions of die product IVoni the Zeny G 
Software Web site at www.ZeroG.com. This 
article will focus on the new 
InstallAnywhere Enterprise Edition. 


lastallcrs are one of tho.se vital tools 
dial no one thinks about unle.ss they don’t 
work. Everyone has experience blind 
clicking “next’’ buttons, only finding our 
after the fact that .something wasn't 
configured conectly or a file wa.s placed in 
the wrong location. Fortunately for 
developers, tocliy’s native solutions make 
the process of building installers for 
plattbrm-specific sofhv^are easy and reliable. 

Tjiln Came Java™,*. 

’Ilie ‘Write Once, Run Anywhere™” 
promise of the Java™ programming 
language lias enticed many developers to 
adopt the leciinology, letting them write 
an application once and deploy it to a 
wide variety of end-u.sers, regardless of 
which operating system they are running. 
In theory this is a ver}- attractive 
proposition; in pnictice deploying soft^^are 
across multiple filalftirms is a highly 
complex process. For example, simply 


running a Java application Lakes a iiigh level of Lechnokigical 
prowess. Unlike the ease of launching a native application, 
launching Java software is a multi-step process that involves 
setting system environmeni variables, and invoking (via a 
command-line interface) one of die many Java class file.s that 
comprise an application, To add a layer of complexity, Java 
software needs a Java virtual machine (VM) installed on the 
system dial C'un execuLc die program. 

Until recently, no way existed to build muiti-platrorm 
deployment .solutions that provide the ease-ofuse and reliability 
of native installaiion tools. Older, legacy installation .solutions are 
not up to the task. First of all, these installers arc platfonii-nalive 
prtKiuct.s and can only am on the platform for which they were 
built. Secondly, they are unable to adapt to the conventions of 
other operating sy.stems. For example, Mac “aliasc.s" arc created 
in an entirely different manner tlien Windows “shortcuts”. 

A Molti-Platform Souition... 

Enter the InstallAnywhere® family of products. 
InstallAnywhere from Zero G Software Is a Java-based tool 
designed to address the challenges oi’ deploying software acrt>ss 
multiple platfomis, InstallAnywhere provides developers die 
funaionaliry' theyVe come to expect in native solutioas, the 
diilcrence is that InstallAnywhere handles all the platform-specific: 
details and allows developers to build a single, universal insc^dler 
that can deploy software to any Java-enabled system from intianets, 
the Internet or CD-ROM. Tills ineJudes Mac OS, IJnux, Solaris, ATX, 
HP-UX, IRIX. OS/2 and Windows 95, 9B and NT. 

Essentially what Zero G has done is taken the time to 
incorporate funairinality into InstallAnywhere that addresses all 
the idiosyncrasic.s of deploying to “native” platforms, and 
provide.s de^^elopers with a powerful design environment for 
building ciistomi^^ed deployment .solutions. 'Ihe l^enefit to 
developers Is tlial tliey have a t(K)i that alUiws them to tailor an 
installation to their needs, and tiiey do not have to be ex|3eit in 
the platforms to which they are deploying. For example, if you 
want to deploy your Java application to a Unix-based .system all 
that you need to do is dick a button. InstallAnywliere deals widi 
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the re.sf of the platibrm spceific ciLiails. Not only doos thi,s make 
il easy rt>r Mac clcveloj^ers who want to de[3lQy software to other, 
possibly unfamiliar, platforms, it also makes the process of 
deploying Java software to the Mac easy. 

Install Anywheres support for llie Mac Ls one of the key features 
tliiit set it apait fixim other mulii-pliittorm deployment tools. Where 
InstallAjiywhere is especially handy is building doutilc-clickable 
appitc'titton launchers. Similar to ‘"ntilivc” launchers, InstaUAnywhere 
creates wlmt are called LaunchAnywhere™ execTJtables that can be 
placed wiierever the end-user choases, such as on the desktop or in 
the applications folden W'hen CTcating UmnchAnywIiere 
executables, LiuncliAnywhere automatically locates tlie correct Java 
VM, conftgures all iimtime options (including classpath) and scirt.s 
die applicition, inaking Java software as easy to run as native 
softvvaiv. Zero G has aLsc> recreated die Mac “look and feel" for lx)di 
the IiistallAnywhere design envuonnient and tor the iasuillers tliat it 
builds. Mac softw^aie dev^elopers and end-users aie assured a 
graphical environment duit Ls familiar and easy to use, 

VlRTlIAI. MACHINF FlJPXIUnJTV 

Another key feature of InsQiliAiiyvvhere is its abilit)' to include 
tlte installation of a Java VTVl with ;my iiisUdler. With the inclusion of 
a Java VM, InstallAnywhere elimin;ites the need to download and 
instoll a Java \TV1 separately, enabling an end user to mn tlie Java 
software they are installing with no added complicatioas. 
lastallAnywhere Ls fully cotnpatible with the most rec'enr Java VM 
technology, including the Macintosh RLintimc for Java (MRJ) 2.1, 


Sun’s Java 2 (JDK 1.2) and Hot Spod“, Microsoft's Java, IBM's Java 
VM, and Symtintec's jU] allowing developers to depltiy dieit' 
s^>frwa^e for itse with Ihe latest Java VM releases, 

Produong an Instm jjek 

Install Anywhere provides developers with two 
inLCTchangeablc design enviromnents, both utilizing a graphical 
interface for ease-of-use. llie six-step Project Wizard Ls an easy 
w^ay to start and allows users to set the liasic pant meters of the 
installer: naming, setting cksspallLS, finding main classes, picking 
which [ilatforms to build installeis for, etc. When youVe ready to 
start adding advanced functionality^ you can easily switch to the 
Advanced Designer Within the Advanced Designer, all of 
InstallAnyw hero’s advanced features are accessible and can be 
manipulated to fit the needs of each specitic installer. 

Walking through the six steps of the Project Wizard entails little 
user intervention. It tndudes six separate GUT [>anels, ettcli with a 
deschptive title; brief iastnjctions for general reference; and cleariy 
defined buttons a Howling for a return to any prowiousiy visited step. 

Tltc prtxrcss begins wiili tlie “New Projeci” satw, whetlier you 
wish to build an installer under the Adv^mced Designer or the Project 
Wizard. 'Ihis .screen is where the designation of a new projet:l lakes 
pfa<'e or where an existing project can l>e o[iened. If you c!icx>se to 
GTO^ate a new ptojed, you will i’Je prompted to brtwse your .system 
and designate a folder and name under wiiich to .save the piojeci, 
OiK'e this is complete, you tan enter the Advancc'd Designer, 
However you may also choose to proceed through tlie W'izard to 
tile seexmd step, the “.Set Info” sneen. 


AppMaker -More than a GUI Builder 

Also helps you write the application logic, 
helps you separate U1 code from functional code, 
helps you connect UT items to functions. 

AppMaker makes it faster and easier to make 
a Mac application. Just point and click to declare 
your data structures, and to design your user 
interface. AppMaker generates resources and 
source code to implement your design, 


Application Logic 
ReadFile() 

GetReminders() 

->Add Ttem(newltem) 

SeLMessage [-.) 

GetYearMonthDay() 

SetHourMinute (...) 


User Interface 



AppMaker generates Gel and Set funelions to 
access your data items and generates code to call 
the Gel and Set functions when UI items are 
changed, and to update Ul items when data items 
are changed. Also generates file I/O code. 

B* 0 *W«E-R*S 

Development 


Users describe the AppMaker-generated code as 
“human professional quality.” AppMaker generates 
C, C++, or Pascal for Apple’s Appearance Manager 
and C++ for CodeWarrior’s PowerPlant. 

AppMaker is just $199 from Developer Depot 
(www.devdepot.com) or from Bowers Development. 


P.O. Box 929, Gramham, NH 03753 • (603) 863-0945 • FAX 863-3857 
h<>wersdev@a()l,c()m • httpV/memhers.aol.com/bowersdev 




























in tile same manner as traditional platfoiin-native applicant's. 


Tl is impoilant U) mMt that all information can be manipulated 
under l>oth build enviranmenls. and is never set in stone until a liuild 
lias l^n completed. Even after tJiis point, a developer can re-open 
an “existinfr" projext, make clianges and rebuild it as many times as 
necesstiry. This comes in handy wlicn a prcxluci recjuires small 
product updates or clianges in flies, which can be handled quickly 
without starting from scratch. 

The "Set Inhr screen is where you add information alxnii 
the project. You can specily such information as the name of the 
product, the name of the instaUer, the name of the installer folder 
and an application name. For added convenience, 
InstallAnywhere automatically fills-in ttiese fields witli die 
project’s name, as noted in the first step. 

Next in the process is the "Add Files” step, where all the 
necessary files and folders diat your project requires are added 
into die installer. In order to support any type of Java application, 
InstallAnywhere ha.s the power to install any type of file: Java 
class files, IfTML files, shell .scripts or hatch files, even native 
shared libraries and execuUibles. Tliis .step is further enhanced 
with browsing capabilities to help you find the folders on your 
hard drive, and a GUI that show.s the hierarchy of files and 
folders (see Figure 1). 
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Figure 2 Selecting the main ckm. 

The fourth step, "Set Classpath”, is a timesaver for anyone that 
has tried to run a Java application l)ui had trouble getting their 
CLASSPATH configured projierly. Tliis is illustraLed in Figure 3. 



Figure 1. Adding film to the pn^ec! in the Wimrd. 


Figure i Setting the classpath. 


One of die trickiest jxuls nf running a Java application is 
knowing wkit Java class file to invoke (Java aptilications inay consist 
of htindrr^ds of individual clas.s files). InstallAnywhere lias solved the 
complexity of Lliis i.ssue by allowing you to automatically find the 
application’s Main Classes in the “Clioose Main" step. Alternatively 
you cm type in the (lilly-<iualilied packige name for yoinmain() class 
(see Figure 2). 

Altliougli not requiied, you can also .specify a titsiom ic:on to 
Ix" ii-WKiated with the application. Tlie^e icons can be placed on 
desktops or in folders and via InstaUAjiywhere’s LaunchAnywheie 
leclinology will serve as die doubIcHrlickahle application laonchers. 
Assigning custom icons for LiunciiAnywheie excx:utables ate 
another w'ay diar installAnywhere helps make Java applications run 


Clicking on die "Automatically Detemiine CJasspath” button 
will notify InsiallAnywhere to kx.ate all files that need to be added 
to your applicition^s cksspadi. (Notice die small, red "(DP" ieon dial 
appears at the Ixittom of the folders. This icon indicates wliich files 
are in the classpath.) Like automatically detec:ting the main class, 
InstallAnywhere Is unique in its ability to determine your 
application's classpath. The alternative, manually determining all 
folders and file ar£:!hives that need to be on the classpath, ^^s 
euml^ersome and Uemendously error-pir)ne, especially if you are 
pan of a larger softwaiTe developmen! team. 

The first three items on the "Build Installer" saeen (depicted in 
Figure 4) in both the Pn)je£a Wizard and Adwinced Designer mfxle 
aie "Win32”, “Mac OS", and “Unix.” These leprcseot die platfonns 
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for which InstaliAnywhere will fjoild tlcjLibic-cUckablc 
LaiincliAnywhere cxcxxitablcs. Tlic final option, "Other Pktforms”, 
a pure Java installer tliat can be invoked on iiny Java 1.1 “a)mpaiibie 
system. You can also decide whetlier you sliould i)ui]d iastaUeni timi 
have an embetlded VM or not. InsLiUcrs built williuut a VM are 
smaller and download faster tlian installers with an embedded VM. 
Tlus size advaintage comes at a prit'e, however: in tjRJer to run llie 
installer, the target platform needs to Imvc a Java VM pre-installed. 
If you are unsure of whetlier your target audience hxis a VM already 
installed on their systems, you might cx>nsicler building Ixjdi 
instiillers, one with and one wiihtmt a Java VM. One of the nice 
tilings about TnstallAnywhcne installers is that they exm tell wliich 
piatlbnn tliey are deploying to and will let tlie end-user kncjw if tlicy 
nc'ed to install a VM or not. For example, the InsiallAnywheie Web 
Install feature will automaiically pick tlie best installer for the users' 
system iw tdlow them to choose which installer they’d like lo use, 
Tlie options are easily outlined anti fxin be t:hosc‘n according to a 
developer's precise needs. 



Figure 4 . Platform imialler optiom. 


At this point you may chtxisc Lo take one of two options: 
either complete die build for the chosen platforms or enter the 
Advanced Designer by clicking the "Advanc:ed Mode” buiion. 

Advanced Feartkes 

The Advanced Designer provides developers with tlie 
opportunity’ to create highly customized dcpkjyiiiem sedutions 
by utilizing features above and beyond those available in the 
Project Wizard. For example, insmUations can execute eusiom 
code, l>e designed to check disk space and retjuire pus.swDrd or 
serial numl>er validation. Additionally, Ir^stall Any where allows 
ytju lo Lailor the look and feel of an installation to an application 
or company image using specialized graphites and text. 

By ofiering such features, ilie lostallAnywherv Jamily of 
pnxlucis allows devefofiers to build depk>yment solutions that fii 
titeir specific deployment netxis. The lastallAnywhere family Ls 
niacfe up of four distinct pftxIucLs tliat [provide developers different 
levels of functionality. For example, InstallAnywhene Now! Ls a 
freeware product dxu provides a very quick anti easy .stilution for 
simple deployments, 'fhe Hxpreis ;ind Stanckiid Editions pitwide 
increased functionality at competitive price points. 1he kitesi 
addition to the family, InstLiilAnywheie Enterprise Edition, pnjvides 
developers the ultimate in customization tiptions. At Uie heart of tlie 
Enterprise Edition Ls an OfKm Application Programming Interlace 
(AIT) tliai allows you to "plug in'* virtuaDy any type of lunciionality. 
For the purposes of this tutorial weVe dtxridcd to ftx'us on die RiU 
capacity of the Advanced Designer tbund within the new' 
InsiallAnywhcre Enterprise Edition, 

Get Advanced 

You may enter the Advanced Designer during any point of 
an installer’s build using the “Advanced Mode” button found at 
the lower left hand corner of each Project Wizard screen. 'Ihis 
gives you the option to create an installer entirely within the 
advanced mcxle. You may also find that it is easier to use the 
Project Wizard to walk you Liirouglt the basic steps of an 
installer’s build, and tJicn use the Advanced Designer to update 
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your instil Her with more adviinced features. Once will tin Lite 
Advanced Designer, you will have access to make changes and 
rebuild your installer as many limes as you feel necessary\ 
Upon entering ihe Adviinc’ed Designee you will encounicr the 
Quick Start dialog lx>x. Tlie content of this dialog pmvides you witli 
srep-hy-step instructioas for gelling siarled wiili InsrallAn^^vhere's 
Advanceti Designer. After bntw’sing its content, you can navigale Lite 
Advanced IX'signer i>y simply pressing any of the tiil>s found on die 
left iiand-side. Unlike tlie Project Wizard, the feiitune panels of the 
Advanced Designer can l:>e accessed bi a random fashion. This user- 
friendly, eusy-io-navigate GUI environment sets Install Anywhere 
apait from other installatitJo ttxils, which tend m operate linearly and 
are difticult to manage. 



Figwre 5. /fLsldlAnywheres 


In this envirtinment you can create an iasUiller entirely 
outside of ihe Pnijetn Wizard, for this reason, the Advanced 
Designer contains many .sections w'h<^se recjuested infomiation 
fields are the s;inie as tliose seen throughout the six steps of the 
Project Wizard. In this tutorial we will focus on the features dm 
set the tw'o environnienLs apart. 

Performing Advanced Actio as 

“Action.s” provide fundionalily to installers built wtch 
Install Anywhere. More sj>ecifically, tiiey are evenis that occur 
during ihe execution of an instalkition. An example would Ix! 
checking to see lanv much disk space is availahie; another might 
Ix^ the creation of custom user dkilogs to rec^uest information. An 
action is set up under the “Files" mb either Ix-Torc* or after the 
neeessar)^ prognim files have been added. The addition of an 
action is as easy as clicking on die “Add Action'’ button, .selecting 
an action and setting the specific variables in llie prudelermined 
fields that apyx^ar, all while remaining under one user interface. 
InstallAnywhere jjrovidcs pre-written actions for performing a 
viiriety of fiinaions; in addition, you can create custom actions 
and f>lug diem in via InstallAnywiiete's Open API. Some of the 
provided actions include die ability to: 


• Ability to add “custom ctxle actions” and user interface 
panels for perfomiing virtiiully any function before, during or 
after an installation, such a.s making database queries or 
sending data to a server. 

• Searcli for existing applications or software components on 
the target system. 

• Add user interface dialogs to ask for apyilication specific 
information. 

• Request and validate yxisswords or serial numiners to Alow for 
aisrom installation lieliavior 

• Extract archives from a variety of fonnats (zip, jar, StulTIl, 
MacBinary, etc.) during an insrallationj allowing for the 
preservation of resource* forks in Mac OS Hies atniss platfbnns. 

• Retrieve Win32 Registry entries. 

• Define, query or set variable.s with the Variable Manager. 

• Display bug infomiation to the console, retrieve Wjn32 
Registry* entries, and more... 

Setting Rules 

“Rules", w^hich differ from actions, am inie-faLse staiements tfuir 
govern die exet:ution of sjxdfic actions, depending on die 
cliamcteristics of die end aser's system, tlie set of rules in 
lastalLAnywhere allow' a develo|xr to: 1) d!et:k if a folder exists, 2) 
verify the platform of taiget sy^ems, 3) check a users chosen 
kxaie/language, and i) perlbnii comparisons between specific 
lastidlAiiywIiere V^uiables. llii.s eombinaiion of choices comes in 
handy when you w^ish to only itin specific actions on taiget sy.stems 
that inatdi spc'cific' criteria. 

For instance, you ciin dicxise to install panicular folders if the 
files do not currendy exist on an end users ha id drive. You c:an also 
include the addition of a license agmement and pnxluct infonnadon 
in Japanese for users who de.signatt* layxinesc as the installadon 
language, or alert an end usct of files dmt w ill be replac:ed before 
iasuillation resumes. For added ease, these* rules are acx;c‘ssible 
under die “Files", “Bundle", "Install Sets”, ancl “Instdr tabs to 
eliminate a umiliersome hunt ihitiugii the Ath anced Designer. 

Install Sets 

Differentiating Ivetween iastullatioas of the same applioition, 
suc*h as a client iasLill verses a sen^r install, or a typical versc*s 
minimal iasUtll, has bfcx'ome increiisingly common bi the softwaiie 
industiy. Tile creation of Ixiih liundles" and dnstal) sets” with 
InstanAnyvvhere simplifies the pixicess ofcmaiing lliesc speciali/xxl 
iasuillcrsi even for the least technicxilly ndvanced develoiier, Folders laiy 
Ive gadiered inR) gioufiings called iKindles, and bundles are grouped 
together to fomi install sets. Tliese .seyxiraie install .seLs. in turn, install 
specific files and nm specific anions depentling on the end user’s choice 
or a taiget system s cltaracterL-aics. 

Set Platform-Specific Details 

Selecting a default position for any alias (shortcut) created at 
install time is necessary when die configuration of target sysiems 
varie,s gready. Determining a set position for die alios on the Mac, a 
shortcut on Windows mac*hines, and directory* for UNIX users is 
installAnywIiere’s solution to this problem. 
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Installer Preferences 

Several visually differL'niiating charuitcnstics can be 
configured in die ‘"InsLalier'' seciion of die Advanced Designer. In 
addidon to providing a visual representation of die main 
classpath settings and specifying rules fur the insialh this section 
lets you customixe die most imp<>rtani parts of the took and feel 
of ihe entire instalter. You can: 

* Choose to exeaite sptx.’ific adioas and rules during tlie Start-up, 
Prt'install or PcH-iastali pktses of iIk" installition pr(x:ess. 

* Configuie the parts of an installatirin that end u.sers will see and 
have control oven This is csfKXially iiiiponanl to developet^ 
unaware of die ex^K^ricnce level of end users. 'HTe options allow 
you to inctude, exclude and configure: 

• Introductory^ text (unahic to cxciude ttib step) 

• license agreciueiiLs 

• [nijx>rumt product infomiation 

* The choice of a destination for files king installed 

* Ihe choice of a desiinaiion for the aliases king installed 

* The clioice of a Java Virtual Machine on which to run Lite installer 

* Tlie ability to pick an msfall .sei (e.g. Typical, Minimal) 

* 'Ihe ability to mn the insiall (unable to exclude this step) 

* A mes.s:ige for display upon the completion of an iasiall. 

* Visually adipt a produas image within an insailler by adding 
bililxMrds that display througlicxji an installation. You cm adjust 
tht:m to dLSjday during the installation of specific biindies of files, or 
have tlieni automatically mn lor equal lime. Atki as many billlxxirds 
as needed to fill the iasuillalion lime, l>ut remeinl>er that each 
billlxxird adds to tlie size of your iastaher (a cmcial factor if you aie 
trying to tonsen^e splice with a small iasuiller). 

CllSrOMLK Saitsi ACnON 

InstallAnywiiere’s customers range from the largest eonmicaial 
and enterprise* software deviHopers uy ilic smallest of start-up 
compjinies. Wliai they all sliaa* Is a common desire to build 
depltjyment .solutioas iliat allow them to successfully install and 
configure their software on multiple-plaifomis. However, each 
company has uni<iuc deploymau cliallenges and requirements. 

Novafex Software Limited 

With help From InsiallAnywhere, graphic designers can 
manipulate the rcstylulion of 5-dimensiomil graphics on vinually any 
operating system, using the latest version of Flamingo Optimizer 
from Novafex Software Liriiiicxi- Flamingo Optimizer utilizes java 
let hnology tty reduce die jxilygon count of graphical images that are 
bound for insertion into Web sites of varied resolutityn reciuirements. 
Novafex chose to dev^elop in Java in order to cater to a huger 
trusitymcT base that could run their software on various platforms. 
Java was also used to S[:>eed up the cievelopmenl process and 
provide cusiomers w^iih a feature rich user interface in wJiich to 
work* However, Novafex found tliat distributing Flamingo Optimizer 
via Ollier multeplatform iastalhition tools had its downside. 


Using other molti'platfonn installation tools to deploy the first 
kia trials of Flamingo Optimizer, Novafex noticed that problems 
arose thai diese tools could noi resolve. After dealing w iili ihree beta 
versions and several instalkiion-rulaled support calls, Novafex 
distxwered InstallAnywhem and decided to give it a tiy. Within m-o 
days of the initial trial download. Senior S<.yFtw are Designer Jon-David 
Lacey was so convinced of its capahiliiics and |>erfonnance that he 
purclmsed the product and forewer changed the distribution pnx'e.ss 
of Flamingo Optimizer. 

“We were verv' impre.ssed ly !iow^ atsy ii was to [>ui a disuibution 
together,'' commented laccy, "'ll was also ap]Xiieni ikit the protiuct was 
well tlKJLighl out from a feature ,st;ind|X)int, 1 was able to atsloniize 
LiuncliAn)wheie files exeaiitxl during an install, spaify (xirticular Java 
Vlitual Machine requirements, and bundle instilled infomiation ail 
within an inluidvc user inierfac'e." 

Sun Microsystems, Inc. 

As founders and Ic^aders in the produerion of rfie Java 
programming language, Sun Microsystems, Ini', faces daily the 
challenge of managing and maintaining the distribution of Java 
technology^ to developers worklwade. One of the products w'hk*h 
Sun deploys with InstallAnywhere is the Java Foiindaiion Classc-s 
(JFO. also known as Swing, 

Ihe |FC Is a amipieheasive set of classes amiing developers with 
java leelmoiogy tailored to add advanced user interfaces (t)l Jfs) lo Java- 
Ixised softw^are, lb make it easier to understand and iiiifilcnient the class 
files, Swing is distributed with demoastraiioas of tlie GUI teclinolog>'. 

Although Sun imitatauis the ahility^ to build an installer on iheir 
own, diey've chosen to use a Jav'a Ivased iasiallatiori tool like 
lastallAnywhere bet:ause ot' ilie funciioniility and ftexibiliy iliai it 
prov'kles. More spedfieaHy, Sun netxled a solution fKit would allow 
useni on any Java technology-enabled platform to install the [iroduct. 
Using bistiillAnywhere liits easumd tliat Sun can deploy the JIG to 
softwnie developers mound tlio world To date over 5(X),{XX) cxjpies of 
tile Java Foundation Classes have been dowmloackxi* 

CONaXJSKlN 

In today’s global computing envtronmenLs "write ojkc, ruti 
anywliere" has never been a moie profound sUilemenL As cxxnputmg 
environments c:ontinue to add operating systenes and compuring 
devices, a|>[ilication deployment solutions need to be flexible enougli to 
meet the deniiinds of tliese diverse envimnmcnis and smait enough to 
understand the glolral sysiems on wliidi they are deployed Ibis tutorial 
lias higliligliied some of the ways in which Install Any where Is 
adda’ssing the complexity’ of mulli-platform dcploytiieni. To fuirher 
explore the produtls, fully functiomil trial versions of all editions are 
av^aibblc femi the Zero G Software Wdi site at: <Mp:/A/wvw.Zero<j.CDrn>. 

HI 
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FROM THE 
FACTORY FLOOR 


by Richard Atwell, ©1999 by Meiroutwks, Inc., all rights reserved 


Debugging AltiVec 


Compile and debug your 
AltiVec code unth 
Code Warrior 


About The Factory I-itkir 

■flic Kactory Floor suiitctl as a means 
I’nr providing a Metrowc^rks presence in 
MficTecb where you I'ovikl read nlxmi tfie 
state ol Code’^C^mior and gel to know ilie 
pe{)ple behind them. 

Dave Mark has l)een writing for the 
Factory Floor lor alwjui as k>ng as I oin 
remcmlx.T. lie’s inteniewed most of tlie 
enginc-ers at Metrnwerks and covered 
pretty much eveiytiiing weVe done since 
the introduction of the Power .Macintosh. 
Dave s done a reniarkalile job month aiier 
month without taking a vacation m wehe 
going to give him a break from writing ftjr 
ilie first lime in four yeans, 

lliis month Fm going to show^ you 
what we've done to tlie dcl jugger in order 
to support the debugging of AltiVec code 
hut first rli update you ctn the progress of 
the U>F and news afioul future updates. 

Factory lipo.viTS 

In the la,st article 1 explained how our 
new update strategy works. The next 
update should have shipped l>y the time 
this anicle apjx^ars in prim. 

Factory L'pdate 3,3 includes upLlaled 
ctjmt>ilers. an updated version of MSL, and 
the latest IDE that c’oniains bug fixes in the 
integrated debugger and incorporates all 


the changes since the last release. The last lime we updated the 
integrated debugger was w^hen we sliipped Pro5 Irack in July. 

The next upthite that we have planned that will come out 
after 3.3 will include carbonized versions of MSL from our 
compiler/library team and a carbonized version of 
PowerPlanl from Greg I >ow\ both based on the latest sources, 
'I'he Pro3 reference CD contained pre-release versions of a 
carbonized MSL and a carl ionized version of PowerPlant 
fiased on the last Prc)4 update, 1,9.3, If you can’t wail for the 
next update, tliat release is a good place to see what’s 
changed although it's a little out of dale with the latest 
Carbon SDK from Apple. 

In addition we'll have a fully Carbonized IDE release that 
includes compilers and a single machine debugging solution for 
Mac OS X. You am catch up on die reinute debugging new's in 
die August 1999 Issue. We’ve added some new features so you'll 
not only get a single iDE dial mas on Mac OS 7-9 and Mac OS 
X but one that conlains new features as w^ell. 

Ai.tiVec: Stipport 

if you Ye ntit aware of what AltiVec can do be sure to 
read Tom Thompson's excellent article on AltiVec (MacTeeb 
July 1999L Vector technology that leapfrogs current system 
performance obsiades and it is built into every shipping 
desktop Power Mucintosh. 

Aside from several debugger hug fixes, the latest IDE 
includes complete su]5[Kjrt for debugging AltiVec code, 'i'he 
Pra5 IDE w^asn'i welt suited for AltiVec debugging becau.se 
the support was inconiplete. AkiVec debugger support was 
originally added to llie IDE 3-3 but because of shipping 
sc hedules, the enhancements never completely made it over 
to the IDE 4,0 in time for Pro3. 

WeVe fixed ibis in the latest relea.se with upcLires to both the 
PowerPC compilers and the integnitcd del rugger. There is al.so a 
new version of the MetroNub Plugin that handles AltiVec and an 
AltiVec enalilcd MeuoNul) extension that also provides support 
for older debuggers i pn)mised in a parvious article. 


Richard A1c?icandrr David Amcll, aka ratw^dk has been witli Melrowcrks for nearly two years. Most recently he has 
been working on the integrated debiigger. You can contact him about the reature.s you want implemented by the nexl 
Mac Hack at ralw el 1 ® metro werks, com. 
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Fast Mac ISAM Access 


Let Luke a tour of the new features. I’ll assume that 
you've read Tom Thompson's article and are familiar with the 
AltiVec l>asics. 


ALUVeC COMPnJll P\NEL 

AltiVec differs from otlier vector implementations l>ecause a 
high level progranmiing interface is available using C/0+. Take 
a look at llie PPC Prexessor panel that is available from yt)iir 
[>roject target .settings. 
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figure 1, PPC Processor Panel. 
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Real-world data managenieni 
soluliuni^ are typically more complex 
when one examines the pieces, 
than iniitaily recognized by the 
majority of dajabase programmers. 
All jityflwarc projects are complex 
puzzJes compri.sed of many details, 
most of which are data-related. QRen 
today^s "’DBMS*" solutions sacrifice 
the speed or control essential for a 
competitive application. 

c-tree PI os*, by FairConi, has 
been the choice of commerci al 
developers for twenty years precisely 
because it otfers the flexibility and 
control at the detail level to fit a 


w. 


wide variety of data management 
needs. Pmven on large Unix servers 
and workstations, c-tree Plus's 
small f(H}tprinl and exceplional 
pertbrmance have also made it the 
engine of choice for professional 
developers on Mac and Windows, 
c-irec Plus offers sophisticated 
ISAM level control with which the 
developer may define precise data 
nmnagetnent .solutions, making il a 
perfect fit for any development 
project requiring specific data 
handling features. 


C-tree Plus*^ offers ehe mose 
mat:ure ISAM solut;ion t;oday.- 


WeVe Lidtlol d fxw tiirget processor called AltiVec, for 
now, this is for tlie only Ci4 class Th>wcrPC processor option and 
it affects the scheduler in the compiler if you have “Scfiedule 
Instmciioas” enabled. Tlie actions taken by the compiler when 
using this setting are based on ihe functional design of tlie G4, 

You'll probably ix ru-writing a small poftion of your 
program to Uike advantage of AltiVec bin you'll still want to 
sup|K>n llie older non-AltiVec prtxessors out theie as weU. 

'I'he “AltiVec Programining Model” option will enable tlie 
extensions in tlie eoitipiler that deal with AltiVec additions to the 
C/C++ language as welt as to changes in the PowerPC ABI. 

In order to help you write your code, when this option is 

on,_^VEC_ is pre-defmed liy the compiler. You can use* tills to 

conditionalii^e your code. Kor example: 

GriipbicftEirginfiO 

I 

#ir _VRC_ 

AltlEnhanred_Scf»neReiidering (); 
rt^eise 

PPC_SceneRetitlerln^{ ] : 
ffendif 
I 


Over the years weVc modified the compiler to .support new 
C++ features and such and the traditional method for wrapping 
your code so older compilers won't try to compile code il 
involved checking the comi)i!er version. 

#if E_hWKHKS_ >* 0x2300) 

H Use the built in compiler friture 

U lUkt it using a workaround 
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FairCom’s 
c-t;ree Plus 
database engine; 

* Advanced Indexing Technology 

* Complete Source Code 

* Complete Trdn.suctjoii Processing 
- ODBC Interface fmm 

Windows clients 

* Over 25 Developer's 
Servers Included 

* Royalty Free 

* Siandalone, Multi-user or 
Clieot/Scrvcr Modelfi 

* Y2K Compliant 

* Supports MctmwcrkR, 

Symantec Compilers 



The FairCom 
Server: 

A solid, high perfomiance 
database server that is scalable, 
portable and offers unequalled 
conlroL FairCom has been pnvvidjng 
database solutions to Uie commercial 
development community for twenty 
years and supporting Mac for nearly 
as long. You won't find a better Mac 
DBMS st>lution. wjUt these features 
and performance anywhere else! 

* Client Side Source Code 

■ Rle Fncryptitm 

* File Mirroring Lxjgic 

* Full Conditional Index Support 

* Full Heterogeneous Networking 

* Multiple Communicalion EYolocots: 
ADSP: SPX; TCP/IP 

* Online Data Backup 

* Small Memory Footprint 

■ Flexible OEM Licensing Oplions 

■ Source Code Availability 


All Chese plafcfarms 
8 up| 3 ort:ea in one package: 

Muc. MIPS ABI. DEC Alpha. Sun SPARC. Windows 9X. 
SCO, K 80 PEN, AIX. RS/6000. nP9000. Son OS. 

IntemcLive Unix, Linux (Alpha,.,), AT&T System V, 
QNX, Free BSD, OS^ Windows NT, Windows 3.1, 
DOS. Netware NLM, & Banyan VINES. 



Oon% WBitf see for yourself! www.faircam^com 

USA> 80a.S34.8180 Email: tnfo^fairccampccim 

FairCom' 

Oa'^abase SOULITiON^ BInc. ,979 ^ 

Phone; USA 573.445.6833 • EUR0P8 +38.035.773.464 
JAPAN +81.59.229.7504 • BRAZIL +55.11.3872.9802 

QJer cmyeiy. product irtJ opOTCna paftrfTl wim#t ere teg^Wlil y trqriBBWka at B»r respiCtwe 






































A gtxxl example of this is how bcx>i supptM in hantUed is 
in Apple's CondtionalMacros.h. For AltiVeCp tlie compikT defines 

_ALTIVEC_to indicate that it can generate AltiVec code. You 

proba])ly won't have to use this as often as_VEC,_so just 

know^ that it's tliere If you need it. 

The “AltiVec Prograniining Moder option allows you to 
enal)le two other sub-options. The first one, "Generate 
VRSAVE Instructions" tells the conipyer that you want it to take 
care of informing t!ic OS which vector registers should l>c 
saved across context switches. A ct)ntcxl switch occurs every- 
time your application is swapped out for another application. 
You might want to turn this off if you were writing hand- 
tooled assembly using our PPCAsm plugin to write your 
AltiVec code. Since the G4 vector unit has 32 128~bit registers 
and saving all of them can take numerous CPU cycles. VRSave 
lets you save specific registers before a context switch 
preserving the .state of the vector unit. Enabling this option lets 
the compiler do the book keeping for you. 

The second option, “Auto Vectorize (Ignored, TBD", isn't 
available yeL This option was intended to allow you to 
vectorize scalar code automatically but w'e liuven't had time 
to implement this yet. 

The last addition for AltiVec Ls “Store Static Vector Data in 
TOC” and you have to enable "Store Small Sialic Data In TOC" 
to enable this option. If you chtx>se this option your vector data 
will be placed in the fragment's TOC w^hich lias the effect of 
reducing the number of memory reads to access the data but the 
trade off is that ycju lotxse some precious si)acc in the TOC, 
Because there’s a 64k TOC-lbnit in the current compiler you'll 
liave to decide whetlier you can trade off the space for speed. 


AltiVec Lanc;iiagf Enhancements 

Tile enhancements to the C/C++ language come in the fomi 
of the vector keyw^ord. You may recognize vector as the C++ 
library's (from the former STIJ sequential container. The 
Mouirola designers w^ho extended the C/C'^+ language to handle 
AltiVec didn't think programmers would Ix' mixing AltiVec code 
and C++ in the same file so they decided to reuse this kleniiRcT 
as a new keywwd in C. 

Altliough this was aw^kw'ard for our compiler writers to 
implement you can now mix C, C++, fii net ion-1 eve I a,sscmldy 
and inline assembly ail within the .same file using the 
Code Warrior compiler 

Vector variables are declared using these new Lypt^s. All 
vetiors are 128-bits wade and are composed of smaller scalar 
elemenLs that are opaque in the sense that you can't directly 
access the elements inside. 


vector [ unsigned 
vector I unsigned 
vector [ unsigned 
vector float 
vector pixel 


signed 

signed 

signed 


bool j int 1*1 
bool ] short 
bool 1 char 


from Momrola. Here's a simple vector declaration: 

vector Linsigned int x = (vector unsigned int) (t, 2, 1, 4) ■ 

Notice that we have to cast the initializer If you don’t do 
thb you will get a syntax error from the compiler. We can also 
use a shortait if w^e w'ant to initialize all the elements to the 
same value (called a splat): 

vector unsigned int X “ (vector unsigned int} (1); 

AltiVec code is written using intrinsic functions. 1hese are 
the C equivalcnus of the assembly language instruciioas available 
in the assembler but take veaor variables as parameters and 
return results in vector variables. Here’s how to XOR rw'o vector 
variables and store the result in one: 

vector unsigned int a “ (vector unsigned int) (255); 
vector unsigned int b = (vector unsigned int) ( li 0, 1, 0): 

a = vector ta* b): 

- result - 
0 255 0 255 

AltiVec add.H 162 new PowerPC iastruclions and the 
cximpiler .supports an intrinsic limciion for each one so you can 
do all your programming from C/C++. 

In addition Co the language changes there are 2 new 
pragmas .supported by the com[iikT: 

rfpraginfl altivec_Jiicidel on | off 
#pragEna altivec vrsavp on | off | alloti 

The first one is et(uivalent to the “AltiVec Programming 
Model” option in the PPC Processor panel. 

The second one allows source ccxle level control of the 
VKSave code generation that was described earlier. 'Ihe allon 
option is like on ext epl all registers are saved instead t^f tlie just 
the <xies deienTiined netmsary l)y the compiler, 

AmVFC MSL and Run iimes 

It) compliment tile clianges in the compiler, w^e’ve modified 
MSI in several ways to support the AltiVcx’ programming model, 

print! and scant both take a new' control string t>piion for 
formatting. The o[>iion,s %vl %vh and %v break up the vector into 
4, 8 or l6 elements for printing and scanning. Like the other 
control strings, you need to postfix these options with a 
conversion option to display hex or decimal For cxam^ilc, tills 
txxle yields the following result: 

vector unsigned int val " (vector utisiigued int} C0x2A): 
printf(" hex: 0x%vlX\n dec: tvhdXu”. vai. vaJ): 

— output 

hex: 2A 2A 2A 2A 

dec: 0 42 0 42 0 42 0 42 


You may have seen code written vviili vector unsigned long, Furllicr additions include vector versions of the C memory 

The int notation ts preferred to the long or long int forms that alienators: vec_malloc(), vec„calloc(), vec_reallc>c(), and vecjree(). 
are deprecated in the final j)rt)gmmming interface specification 
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Tliese routines return a 16-byte aligned address. This is very 
important for acairacy and maximizing the performancu of the 
vector unit so be sure to use tliese with vectors variables instead 
of tlie [UJriiial forms, 

rhere are no special versions of the MSL C.PPC.Ub or MSL 
C++.PPC.Lib lil>ranes that you are required to use with AltiVec 
largeLs but you do liave to select the correct runtime library. 

The AltiVec programming model places some extra 
restrictions on the P{)vverPC ABI. One such restriction 
invi)ivcs 16-byte alignment of data in memory. For example, 
stack frames have to be created and destroyed with this 
restrict I DO so we've had to provide vector implementations of 
setjmpO and Iongjmp(). Changes to our C^-^' exception handler 
to support AltiVec were also required. 

You'll need the correct version of the runtime routines 
depending on ihc AltiVec ctxle generation setting. If you use any 
of the libraiies on the left, lie sure to use the AltiVec equivalent 
in your AltiVec targets. 

H$l KPUCRmitimeFPCTib -> MSL MPWGRunLiitieAl t iVec-Lib 

MSL RuntisnePPC++.DU ->MSL RuntijEeAitiV(ic!++. DLL 

MSL RuntiraePPG.DlL ->HSL RxuitimeAitiVec^iJLL 

MSL RimtitnePPC.Llb ->MSL RuntimeAitiVec.Lib 

MSL StflCRunrimePPC^Llb ->HSL StdCRuntimeAitlVec.Lib 



Figure Z Bcample Project Window. 


rhat briefly summ^irizes what's changed In the compiler and 
the libraries. IVe only covered the basics here and you can read 
about all the details in the ^AltiVec Technology Programming 
interface Manual" from Motorola. Apple's website has a good 
introduction to AltiVec: and theyVe provided .some sample code 
for your as well. 

AltiVec RECiLSTER Window 

Debugging your AltiVec code is just as easy as debugging 
any other code using CodeWarrior. 

Vector variables can be stored in vector registers or they can 
l)c stored relative to the stack as local or global variables. You 
can use the register keyword to ask the compiler to siorc 
variables in registers bur it's up to the t:[>mpiler to honor tliis 
rccjuest just like any other variable, 


"IN JUST A FEW SECONDS I'VE SUCCESSFUULV TV1ACKEP 
OWN A MEMORY COftftUFTION BUO THAT HAS BEEN ELUD¬ 
ING HE FOR ABOUT 3 MONTHS. FANTASTIC >)" 
-B(tYAN CHRISTIANSON- 


sroTLioriT 


The #1 Macintosh bug detection tool! 


• Detect memory leaks automatically 

• Instruction level bounds checking 

• Validate 400 Mac Toolbox calls 

• Pinpoint stale handle usage 


• Integrated with all Mac debuggers 

• Debug shlibs and stand alone code 

• Faster than ever before 

FRKE 
DEMO 

941.795.7801 Fax: 941.795.5901 
www.onyx-tech .com sales@onyx-tech.com 





To make the viewing and manipulation of vector registers 
pcxssil)lc a new register window was designed and it available 
from the Window menu. Because vector registers are 128-biLs 
wide the AltiVec Register window was created as a resizable 
window so screen real estate can be preseivecl as much as 
{X)ssible and a scrollbar has been included so you can navigate 
within tlie window at any window size. 

Unlike tlic General and FPU Register windows, there is a 
zoom control so you can maximize and minimize the window to 
examine the contents of all registers with a single dick. If die 
window grows so that part of it w'lll dniw off-screen the window 
positions itself to liie borders of the monitor so the entire 
window is visible, Clicking zoom again will restore the original 
window position and scrcill the window to the last register you 
were Icx^king at. 



Figure J. A/tiVec Register W'mdow. 
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Bccau.sc vuclor variat^lcs really just contain niultipies of 
SGilar elements each register Is broken init> 4 324 >ii <juantities. 
This is useful for viewing elements as iots^ shorn, chars and 
floaLs. When a vector register changes value you'll notice that 
only the scalar element that changed is draw in red instead of 
the whole register. I'his helps you notice bugs in your cckIc as 
you vec:tc)rtze your existing algorithms comparing them to the 
original output the generate. 

f'inallyj there is a contextual menu available tlial you am 
activate to change the display fc^rmat from hex to float. When 
you do this for any scalar element ail elements change at once 
as a convenience for you. 

ALnVEO Stack Cra\st. Wrivnow 

Motorola states that vector variables are opaque structures 
and access to individual elements inside is forbidden but that's 
not very useful for debugging purposes. 

Displaying veaor variables as 16-byte C|uamiiies was 
awkw^ard so we decided to display vaiiables as structs with 
array like lalK'Is. Take a look at the stack crawl window' and 
youil see vector variables in registers are denoted with a 
®VRx label in the right column or an address whieli indicates 
that varial>les are stack-based . 


figure 4. Slack Cmwi Window, 

Normally variables in registers areiVi derioied in the register 
name l>ui for vettor variables we do because tiiey are treated as 
structs in die deliugger and siniets c:an't fii w'ithtn registers. 

When disclosed, vector variables reveal die scalar 
elements that make up the variables. When the variable 
changes only die elements that change will hilite in red just 
as other array or struct elements hilite when changed. You 


in one shot! 

The MacTech CD-ROM with THINK 
Reference Is the essential referenct 
resource for Macintosh programmer 
This CD includes the THINK Referenc 
personal database system and a weal 
of Macintosh programming database 
featuring almost 170 issues of the 
journal of Macintosh programming ■ 
MacTech Maga 2 ine.This release aisc 
features the THINK Reference Compil 
which allows you to compile HTML fil 
into your own compact, searchable 
THINK Reference databases, and th< 
THINK Reference Collector for buildii 
new Mac OS API Databases. 
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can also etlit tfiemems one at a ttme which is much easier 
than liavinjr to insert text into a 16-byte hex value. 

You can convert any of the elemenLs using the Data 
menu to display the elements of a vectors as hex, signed 
value or other convertihie formats. Because some vector 
variables have 16 elcmenis inside weVe automated the 
formatting of all elements at once whether they are in 
registers f>r on ihe slack. You can also reformat elements 
using the ccmlcxtual menu* 

Vector variables can he thought of arrays of scalar eiemeoLs 
but if you remember 1 called them structs earlier. I'liis is an 
imfxjnant distinction [>cc:ause you can't use array notation tf) 
access vedor variables in expressions. 

For expressions and conditional breakpoints you need to 
tliink tjf them as sirut'is* Here's an example that will stop at the 
break[X)ini when the first eleitient of result etfuals 69* 



Figure % Conditional Brmkpoints using an aypression. 


The [Ol is the lalx.‘l of tJte first element inside the veilor 
variable restilt. If you find tills odd you’re probably ntn alt>ne 
Ixrcause this isn't valid cyc++ synt<ix hut at least we have a W'ay 
to use vector varialrles in expressions* 

Df\t.lopmfnt Tips 

Once you learn ilic insirinsit' operators* you can concentniie 
on vectorizing the liottlenecks in your program instead of 
dealing with the aw^k%vardness of assembly language. Optimizing 
AltiVcc code is anotlier article by itself, maybe even a Ixwk hut 
here are a few' tips to consider. 

.Mways look tor register spillage, lliis occurs when there 
are too many variables ami Ujo few registers to store them in. 
Spilled regi.sters arc stored on the stack and it's well known 
I hat programs run faster when computation is dt>ne enttrely 
in the registers. 

Look for dependenLie.s that reduce the usage of the 
multiple functional units within the G4 processtir. Try to 
interleave usage of the permute unit with the integer or 
floating point units. For exanijile: 

Permute, aultiply, permute, xor, permuie, atld, etc. 

You am easily double your performance using this technique. 
Hisfly, always double-check your alignment. AltiVec register kxids 
and stores must always lie 16-byte aligned in memory so if you 
don't abide by Ujc mlcs your code w^on't lie corred. 


Summary 

Being able to write vectorized ccxle in C/C++ and debug it 
with a source level debugger Ls a huge improvement over other 
vector implemeniatir>n.s like Intel's MMX, SSF and AMD's 3DNow!* 
Because the Ccxle Warrior compiler has full C/C++ support 
for the AltiVec programming mcxlel you only have to Q.se 
assembly in you w^ant to. For example, all of Photoshop's AltiVec 
su[>(xiil was written entirely in C ; no as.sembiy. 

'fhis capability makes it a lot easier to integrate and reu.se 
ccxle as well ns debug and maintain your programs than if you 
had to write and debug entirely in as.sembly. 

Gtx>d luck with your AltiVec endeavors and come visit our 
[xx>th at MacWorld SF in January 

Ki-flrejv(:f.s 

• AkiVec technical references: 

• AltiVec Heveated, 1V>m 'Fhompson, Madech July 1999 

• AltiVcc Technology' Programming Knvironments Manual 
<http://www*mot.com/SPS/P 0 wefPC/teksupport/teklibrary/manuals/ 
altivecj3em.pdf> 

• AltiVec Technology Programming tnterface Manual 
<http://www.molorola.com/SPS/PawerPC/teksupport/tGkljbrary/manuals/ 
attivecpim.pdf> 

• Universal Interfaces: 

<http://developer.apple.com/sdlc/> 

• Websites for Altivec: 

<http://devGlopGr.appie.com/hardware/altivec/inclex.html> 
<htlp://www.motorola.com/SPS/PowGrPC/AltiVGC/> K1 
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http://www.mdg.com 


WS4D/eCommerce 

a single application 
that does it all! 


Web Server 
Database Publisher 
eCommerce Server 
Handles Virtual Domains 
and all your Databases 


WS4D Pricing: 

WS4D/eCommerce Single Store.$49S 

WS4D/eCommerce LinUmited Store..$795 

Upgrades ovailable for existing WS4D Customers 

• eCommerce Module gives shopping carts 
and Authorize.net support. 

• Publish databases (Sherlock Optimized) 
without purchasing CGI's or Databases. 

• Already have a web server? WS4D/eCommerce 
can run os a web server or CGI to your 
existing web server! 
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Learn more about W54D or download a demo online at: 
http: //WWW, mdg.com 






















PROGRAMMING 

TECHNIQUES 


by Erick Tejkomki 


Speech and REALbasic 


Add powerful speech and 
recognition abilities to your 
REALbasic application 


iN'inooucnow 

Ever since the first Miicinttxsh arrived, 
speet'h has been an interesting addition tt> 
the Mac OS. Computeriiced sfK'cch lias 
iK‘cn a mainstay on the Mac since day one. 
It lias evolved over the years into its 
current state, changing names a couple 
titnes along the way. The ability of having 
your computer speak to you is invaluable, 
leading to the development of a variety of 
appliraiions. Ycju am now have your 
email, caller ID, or web pages read to you 
thanks to Apple's speech capabilities. A 
little later, the Mac OS l)egan shipping with 
English speech recognition softw^are. 
Instantly you could control parts of the 
Macintosh through AppIeScripLs in die 
Speakabie Items folder. There is also a SDK 
available from Apple that shows how to 
implemeni speech recognition in your own 
applications. Althougli it has Iieen possible 
for a number of years now, it has not 
always lieen particularly easy to 
implement. Tlie SDK required extensive 
knowledge of C++ object programming, 
luckily, some thoughfLil programmers have 
put itjgelher a whole collectitin of ttxils to 
control and use speech and speech 
recognition in your own applications. 

What this means for REALl^asic 
programmers is that you now have 


convenient access to all of the aforementioned speech abilities. 
Willi little effort, you can quickly have your computer Ixirking out 
phrases. Furthermore, you c’an implement speech netxigniiion in 
your own applications. llEALbiisic offers several manneni in wliich 
to implement eac:h of these functions. TliLs article wiH attempt to 
cover all of die various ways to add speech and speech recognition 
abilities to IdiALhisic appliartinas, Adv^mtage.s and disadvantages 
will also be disoLssed for each of the nietlKxis. 

Text to Speech 

Getting your REAU>a.sic applic:ation U) s|>eak can be 
acxiomplished in a numlx.T of ways. Deciding on which mediod is 
most appropriate or convenient for your purposes can most easily lx? 
accomplished by examination of aich methtxl As we discu,s.s each 
of the meilxxls, we will build a sample application in REAUiasic. 

AppuSemvr 

AppleScript is a hist and simple way to add sj>eeeh abilities to 
your REALbasic application. REALliasic Is aijxible of diiecdy calling 
AppleScripts and AppleScript Ls able to contrt>l the Tcxt-toSpeecii 
abilities of the Mac OS. ‘lb demoastrale, Ix-gin by ojxjrdng 
REALbasic and starting a new [mijecl. Tt> Windowl add an EdftRdd 
and a PushButton. Change the Caption Property of the PushButton to 
“AppleScript^' and put the following axJe in the AcWm event: 

Sub Actlout) 

dim i as string 

i=SaySoifleStriiig CEditfieidl. text) 

End Sub 

The command SaySomeString is the name of the AppleScripi 
we will use to speak a string of text; the text contained in the 
EditField, to Ixf exact. Next, start the AppleScript Script Editt)r 
application and write a simple stTijit as follows: 

on run txl 

tell application “Finder* 
say X 
end tell 
end run 


Erick Tejkowski is a Web Developer for Live Zipaiom Goinpany in St. Ijotii.s, Missouri. He'.s Ixen programming Apple 
computers since the Apple 11+ and is still waiting for a new version of Beagle Brothers lo lx- released. You can reach him at 
e ji @norcoin2000. com. 
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'llie variable x is the strini? wc will pass to tlie script from 
REALbasic. The On Run staiemeai allows AppleScript U) aa:ept a 
value froitj outside AppleScYipi. Save Ifte script as a “CtHiipilcd 
Script"* and name it ‘*SaySomeSirin^”. Next, drag the cotiipiled 
.scTipt into your liEALbasic project. By now, your HEAlimic 
pn))t*ct should look like Figure I 



figure L Sfm^ch via AfpleScfipl, 


Select Run from tlie Debug menu to test the project so far. 
type some text in the EdilField and press the PushButton. Your 
Mac should speak the text* Now, wasn't that simple? One 
disadvantage of this meiliod is that the computer has to rely on 
AppleScript Co perforin tlie sfx^ech t:ommand. Since AppleScript 
is acting as the intermediate between your appliauion artd the 
D[>erating system, performance can sometimes be a tad slow 
(particularly on older machines)* Moreover, AppleScript must lie 
installed for this to w'ork properly. 

To avoid the dependence on AppleScript, several other 
methods can Ik* used lo accomplish speech. They include 
shared libraries, native system calls, and REAlixisic phigins. 
To demonstrate each of these methods, we will add three 
more PushButtons to the Windowl of our project. Set the 
Caption property of each PushButton la read "ShareclLib", 
‘'SyslemCair', and "Plugin"* respectively. 


SiiAKe) Libraries 

Shared libraries are collections of pieces of mde that 
exist in your System Folder (typically, but not always, in the 
Extensions Folder) and arc simultaneously available to 
mulliple applications* The S[Kech functloris are accessible 
through commands to the SpeechLib Shared Library* To add 
the SpeechLib to your project, drag the Speech Manager 
Extension from the Extensions Folder inu> the RFALbasic 
project window. Once the SpeechLib has been added lo the 
project, REALbasic must Ik- told what function**? to utilize 
from the library* This is accomplished through '"Entry Points'*, 
To add an entry pointy double-click the SpeechLib In ihc 


project window. A window will appear that allows you to 
add entry points* Click dm Add button and enter the 
following information; 


Listing 1, NewSpeechChannel Entiy Point for Speechlib 

Name; NewSpeechChennel 
Parameters; Ptr, Ptr 
Return Type: Integer 


Be certain to enter this information exactly as printed, since 
case matters liere* This inff>rmation tells lUiALbasic to add a 
conimitnd NewSpeechChannel accepts two pointers as 

parameter.s and returns an integer. 

Siiniktrly, add entry points with the infbmiacion in listing 2. 

Listing 2. ITie remaining Entry Points for SpeechLib 

N flme: Dis poeeS peechChannel 
Parameters: Ptr 
Return Type; Integer 

Name: SpeechBviny 

Fareiieterisi 

Return Type: Integer 

Kiime; SpeakText 
Parameters: Ptr, Ptr, Integer 
Return Type: Integer 

Name; GetlndVnir.e 
Parameters: Integer, Ptr 
Return Type: Ptr 


Next, create die following properties in Windowl by 
selecting liie Ed it... New Property menu. 

ChannelPtr(O) as HemoryBlock 
teict(Q] as MemoryBlock 
VttlcetO) as NemoryBiock 


Finally, add code to the Windowl Open event and to the 
PushButlon2 Action event as shawm in Listing 3^ 


lasting 3> 

Windowl*Open: 

Sub Open{) 

ChannelPtr(O) = neTiraieinQryBlock(4) 
text(O) = newmemoryBlock(255) 

End Suh 

WI nd owl * PustiButton2 . Action: 

text (0)*Cbtring(0) ^ Editlieldl.text 

OSerr SpeechLib.GetIndVoi^:e(7,Vo^ce^0)) 

OSerr SpeechLib*NewSpeechCbannet(Voice(0), Channelftr(0)J 

OSEcr SpeechLib * SpeakText(ChannelFt r(0),Ptr(0),text(0), 
len(text{€) ,CGtring(0])) //This is all one line! 

while (SpeechLib,SpeechBusyO <> 0) 
wend 

OSerr SpeechLib*DisposeSpeechChannel(ChannelPir(0).Ptr(O)) 

End Sub 

Selea the Debug.**Run menu to test it* Type in some text 
into EditFieldl and press the “SharedLib” button* You sht^uld hear 
your text spoken back to you in Kathy's voice. Tills occurs widi 
no reliance on AppleScript. 
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To loam more about Shared Libraries, please eiieck the 
references at the end of tliis article. In particular, look at 
Christian Brunei's site, lie has a detailed explanation ot 
working with Shared Libraries in IlEAl.basic. In fact, die code 
presented here is a scaled-down version of his. He goes into 
much more detail^ so don't miss it! 

Systfm Toolbox Calls 

if all of the shared library preparation seemed a bit 
daunting, never fear. KOALbasic has added the ability to 
make system level Toolbox calls. To call system APIs from 
REALbasic, you must use the Declare statement. While not 
necessarily a topic for pure beginners, a freeware application 
entitled TBFinder (listed in the References at tlic end of this 
article) by Fabian Lidman helps tremendously. Purtherniore, 
Man Neu berg’s book also discusses the topic in greater 
depth. For speech purposes, our sample application will 
make use of one Declare statement. Add a third PushButton 
to Windowl and change the caption property to read ’'System 
Call”. Double click Push Buttons and enier the code in 
Listing 4 into the Action event of the PushButton. 

Listing 4 

dial s as string 
dim i as inieger 

Declare Function SpeekSiring Ub "SpeechLib” 

(SpeakString as pstring) as Integer //This is; all one line! 
s=editFleld1.text 
:l=SpeakStr1ng(fi) 

This example comes to you directly from the REALhat^ic 
Developer Guide, li shows how you c:an eliminate all of the 
messy steps involved with the previous shared library call in 
one siaiemenl. The Declare function can call any number of 
system level calls, A good way to discover them is to read 
Inside Macintosh and the Mac OS Universal Headers included 
with CodcWarrioL Again, be sure to look at 'IBFtnder, It 
lakes away much of the guesswork of Declare slatcnienLs. 
Since Declare statements deal directly with tlie system level 
APIs, the parameters and return types are often C data type.s 
that might be unfamiliar (if not downright scary!) to the 
REALba,sic programmer. Some of this ugliness was the reason 
folks flocked to RKALbasic in the first place, which leads to 
the next topic. 

REALbasic Plugins 

The final manner in which we can get REALbasic to 
speak text is by using a native plugin, REALhasic supports its 
own native plugin format. Simply drop a plugin into the 
Plugins folder located within the same folder a.s the 
REALbasic application. Restart the KBALba.sic application and 
it will now have the added functionality that the plugin 
provides. You wall need io check the documentation for the 
plugin to learn about its methods and c:ontrr>ls it adds. For 
our example, w^e will ii.se the VSE Utilities Plugin, It has 


recently been made freeware and you can download it from 
the site listed in the Reference section of this article. Add the 
plugin to your Plugins folder and re.start REALbasic, 
remembering to first save your project before restarting. 
Once restarted, load the project again, and drag a fourth 
PushButton onto Windowl. Change the Caption property to 
“Plugin", Double-click PushButton4 and add the code in 
Listing 5 to the action event of the PushButton, 

Listing 5 

dim i ae integer 

i=Epeak{Edifieldl.text) 

The plugin adds a Speak rncLhod to REALbasic, All of the 
work is done behind the scenes. The advantage here .should 
l>e obvious - simplified code. The drawback Is lliat you are 
at the mercy of the plugin program juct to properly write the 
code, to upekte it regularly, and to code it efficiently. Still, 
when a plugin is available for a particular function that you 
need, your work will be drastically reduced by using it, 
Eurihermore, ir conforms to the REALba.sic programming 
methodology, wliich does not require extensive knowledge 
of the sometimes-complicated Mac Toolbox. Figure 2 shows 
the completed demo project. 



figure Z The compleled Speech.n project. 

As you can see, REALbasic offers a number of ways to 
make your Mac speak text. The idea here is not only to show 
you that speech is possible in four differeni manners, but that 
these four methods can be used in other instances of your 
applications, It is up lo you to seek out the vast number of 
abilities that these methods afford yoiu When REALbasic 
does not support a function natively, the programmer may be 
able to accomplish the task using AppleScript, shared 
libraries, direc:t system calls, or pkigms. 
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Spffch Recognition 

Speech reco^niiion afnlitics can Ik* added to your Mac by 
insuilling Apple’s Speech Recognitit>n packa^^e. RRAlJiasic 
currently f)(fers two different ways to add Apple's stxwh 
recognition abilities lo your apf)licalion: Speaksble Items and a 
RHALliasic j^lugin. Both rely on Apple’s Sptxrcli Retognition 
technolc^gy, but vary in how they respond to spr>ken conunands. 

APPIiiSc^RIPT 

When Apple Speech Kecognitton ts installed, a folder 
entitled Speakable Items is |>liucd in your Apple Menu Items 
folder- Willi in this folder are AppleScripts and aliases to files 
you wish lo open. The idea is that when Speakable Items is 
turned on through the Speech Control Panel, the Mac will 
listen for the phrases kmnd in the Speakable Items folder. If 
we were to place our ow'n AppleScript in this folder that 
w<>uld control a RRAlbasic applit'ation we have written, then 
we couki conirol the Mac with speech. An excellent tutorial 
ainmi making an Ap]>leScripi-ahle REALbasic application can 
be found at the KB Monthly site. Follow^ the tutorial keeping 
in mind that you want to send speech commands to your 
own application, rinally, create AppleScripts that control 
your applicatitm and drf>p them into the Speakable Items 
folder. You will also want to clieck the KlLALhassc 
docuincntation fur information about how KFAkbasic 
applications respond to AppleHvents. 

Appli; Event Plugin 

The second methtid to implement speec'h recognition in 
your own application is a hit more complex, but luckily 
Maithtjs van Duin has made the job much easier. His sample 
project details the use of speech recognition ami offers 
classes and mtaJules for u.se in your own [>rO]ects, In 
addition, the result Ls a self-contained speech recognituvn 
example without relying on the higher level AppleScript. 
Instead, his example relies on an AppleEvent plugin for 
REALbasic called AE Gizmo by Alex Klepoff , The AE Gizmo 
plugin allows a REALbasic programmer to use AppleEvent 
strings in Uis.so CaptureAE format within REALbasic. So, be 
sure to also download the Lasso CaptureAE plugin. To say it 
another way, you need the AE Gizmo plugin anti the projec'i 
from MatthifS van Diun to do .self-contained speech 
recognition with KHAI,basic. If you would like to do other 
types of AfipleEvcnls commands using Utsst>AH results (as 
the .speech recognition example does), then you als(j need to 
download UssoAR* This article will not go into detail ulxjut 
the use of AE Gizmo. That is up to you to explore. A version 
of AE Gizmo also accompanies Matthij.s van Duin's example. 
It is manckitory that you use one of the newest Alpha release 
version.s of REALbasic for tlie speech recognition example, as 
it makes use of some new' features in REAl.basic. Yf>u c:an 
download the developer releases of REALbasic from the 
REALbasic dtmnload page. 


Conclusion 

Adding speech and speech recognition capabilities to 
your applications u.sed to be the stuff of dreams, REALbasic, 
along with the help of several third party add-<ms, gives you 
the ability to add speech and speech recognition capabilities 
to your own software. As Apple continues to improve each 
of these technologies, you will likely be able lo reap the 
benefits with little or no additional code. You can \w certain 
iluu speech will be a big topic in the future of ctunpuiers and 
with yt)ur Mac and a c<jpy of REALbasic you can take 
advantage of speech and speech recognitUm today. Now get 
otU there and w^dte stmie speech stiff ware! 
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PROGRAMMER'S 

BOOKSHELF 


4 ^ Paul E. Seving, Switzerland 


Computer Snafus 


It’s Qiristm/VS 

Nl-vltiIicIcss was I kx)king fowaid to tear this month's Ixxjk to 
pieces when I tot saw its awer I liioughi to have some kind of 
^tabloid's digest” In my kmd, after all. — But 1 tm'd. 

Q)mpijter What? 

Written Jlenmn McDanM and published by Cbkom 
PiJTiLshing, Computer Smjits: Cmshes, Iirron, Failt4fvs, Foiil-ifxi, 
Goofs, Gliicbes, mid (^hcr maljunoiom that cattse computers to go 
^tt/J?>'lMcl>aniel 1998] is iin anllioiogy' of c^anputer int idenis in the 
widest sease. 

I hadn't lieanJ the word ""snahts” before, h jr the Ix^neht of those 
reader who liaveii't eitlier, let me t:ite the ixx)k's intrcKktction: 'Ihe 
American militaryf contributed to our uctcabuhry the uxrd -sitafu- 
(dejimd in dk:tkmaries as >sUiuitkm nonml ail foithd-ufrl. Far the 
record, the f in ^sm/u* inilkdfy did not standfor fonkd-r 

14 Qlirstions 

The title of eac'h of the Ixx^k’s 14 cli;ipters is a c|ue.stion. %'an 
Bankers Bank on Computer TecbnoiogfC*^ for iasnince, or *'i)o 
CampnUrs Rmlly Kill Ik^pleF\ The cliiiplers aie live k> thirty pages 
long and tx)ntain ineideriLs that sometimes need several [xiges and 
sc^metimes tmly need a eouple of lines. 

A few of die ineideriLs McDaniel refK>its on didn't teally involve 
a ujjnputer, they [UM happened to happen unmnd once Ttikc the last 
jxiragraph of llie tliiid chapter, for example: ‘Acamling to Itie 
'Hmes* the brunch mauagy^and an msistant had act idt^iialiy locked 
ihemselues insidt^ the AIM safe, Ms, Burnett imrd the manager, 
{deading to he ki oiti. Fk* managr^i to jrass the afpnpriate 
through the AIM to Burnett who then (4}eued the to free the 
embamissLd couide. 

Many incidents uererCi censed by faulty software or haniw^are, 
but by people accidentiilly cutting filxT cables, by heiivy stomis 
damaging aimputer centers, or by otlier non-techniail mtstms. f 
liked that McDaniel takes rhe time to tell how engineeis and 
maoiigers coped with these situations. 

AI:ls, nuny incidents teere aiirsed by faulty software or 
iiarUware. Agiiin, McDaniel doesn't confine liimself to refxmlng on 
the consequences only. If die clause of the errors w^is disclosed, the 
re;ider learns it as well. 

In st>nie cxses, the hartlware or the stiftwan? tLsclf was “tlie 
incident”. NanK'Iy wlien ilie development didn't meet the schedule, 
cost more tlian anticipated, or wasn’t cumpleic-d at all! 


iNCEVnVl: TO DliVKiXJFmS 

Among all readers, Comptiter Snafus should make us 
developers think most. Did people really have to pay with their 
lives becau.se of a hardware bug? Was it necessary to spend 
millions of tax dollars before realizing that a software project was 
doomed to fail? — In defense of ihfxse engineers who were 
involved: I'm sure they all worked to the l?cst of their knowledge 
and belief. And the developer community in general lias learned 
fonn tlicir mistakes. As a matter of fact, mast m-.\pr foul-ups 
covered in the book ItaptX'OciJ l)erore the nineties, ('ttiey still 
happen, though: at the time of this writing, die Mars Ctimale 
OrMer I 0 S.S isee llIKLll is the latest example.) 

CONCLLfSIOJN 

Despite McDaniel’s factual writing (which, in my opinion, is 
a gotxl tiling), Computer Snafus is niiher eniertaintng. Sometimes 
1 wondered wiieilier Dogheri liad u finger (sorry, a paw) in the 
pie... *nie only thing 1 can reproach tlte btx)k with is tliat die 
layt>ut dex-sn’L make tiear where the coverage fif one incident 
stops and die next starts; not every reader will want to read about 
every single one of them. 

(:t)mputer Snafus is not a must-have: if you have to choose 
between this b(X)k and one alxxii st)fiware rtiiabtliry (or the like), 
chrxxse the latter. However, I tend to cotLsttler these two to Ix^ 
complementary^; Cximputer Snaliis provides the motivation, the 
textlxx>k the actual UkjIs and tcxiinitjue.s for wanting bug-free 
sf>ltwaa". (Hey, 1 cun dieam, can't I?!) 

Anyway, let's end this review with an exceqit from the last 
chapter: ""-Compider Glitch ‘Kills' Comlitutkyru, proclaimed a 
Washington Post headline on Sutiday, June 3(1 1991, Jheariicle, 
f?y Dougins Farah, rafKiried that Colomhia's nae constitution 
might not be approued hecaiLse *...a computer aplxtrently ate the 
texty Merry Chtlstmas! 

RfFERFJV(XS 

iMcDaniel 1998] MCDANlIiL, Herman. — Computer 
Snafus: Crashes, Errors, Failures, Foul-Ups, Goofs, Glitches, 
and other malfunctions that catm* computers to go awry\ 
Chicoru Publishing, 1998. 

URL 

<http://mafs.jpl.na5a.gov/msp98/orbiter/> n 
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¥)u’ll be stuck in 
San Francisco’s heaviest traffic 
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TOOLS OF 
THE TRADE 


by William Porter, Polytrope Solutiorus, Houston, Texas 


Lasso 3.5 


The leading tool for Weh- 
pubUsbing FileMaker 
databases extends its reach 


fcslUOinKTlON 

'I'he Lasso Wel> Data Engine fnmi Blue 
Worltl Commimiaiiions (henceforth simply 
“Lasstr) started life .several years ago as a 
prcxitict that made it jx>ssit)lc to piihlisfi 
anci manage FileMaker Pro databases on 
the World Wide Wei). Originally, if worked 
only with PileMaker and only on the Mac, 
even after PileMaker went crtjss'platfonn 
three years ago. 

Uisstj is still the premier tcxil on the 
Mac for Web-enalding FileMaker 
tlaiaba.ses, but it has expanded its reach 
considerably. In fall 199H, with the release 
of version 3^ Lasso not only broke out of 
tlie Mac OS and expanded into the 
Windows world; it also grew beyond 
FileMaker, by adding .support for any 
ODBC compliant data source. And by 
enriching its tag-based programming 
language, LDM1„ Lasso iiiuiurcd into a tool 
that can do a lot more than di,splay a 
product ILsi online. It is now used 
increasingly to (xiwer dynamic: Web site,s 
whose HI'ML pages are generated frrjm a 
datalrase that the user ntay never even be 
aware of. In fact. Lisso can do a lot to 
enhance Web sites in which no dataliase is 
involved at all, 


Lasso 3.5r released in late spring 1999, Ls not the feature- 
paerked breakthrough that the previous version had been, 
laslead, 33 consolidates the earlier advances (adding expanded 
Windows support, for example, and strengthening security), adds 
a handfiil of powerful advanced features (such rLs support for 
server-side JavaScript and XML), and expands tlic prtxluct line 
with a variety of new features, including the Lasso Developer 
Editicm. I'he release of FileMaker Pn) 5 almost six months later 
fOctoIx^r 1999) made it easier than ever for inexperienced users 
to gel their data tjnline in a hurry* Nevertheless, Lasso is not a 
product for Web neophytes looking for c|uk^k solutions to simple 
problems, and the release of FileMaker 5 is unlikely to draw a 
single seriou*s developer away from Lasso. 

Tliis review article Ls addressed nor to developers who are 
already using Lassex but to users who are wondering if they should 
give Uis.sr> 33 a try. Ihe short answer is yes. Since I am a FileMaker 
developer, mrjst of my examples refer to FileMaker Fro databases* 
But if you work with an ODBC-compliant data soufice such as 
Micrtxsoft Access (Windows only) or SNAP Innovaiioas’ PrimeBase, 
nothing said hem is irrelevant to yr>ur a:jncems, since Lasso's 
ODBC module works very much like iis FileMaker Pno counterpart. 
(The differences are mainly terminological.) In order to tackle 
Lasso, you do not need to have an advanced programming 
background, but you should be familiar with programming or 
.scripting concepts, and you must know HTML pretty well. 

Tile ctxle examples given in this article come from a simple 
site svhose full source code can be downlcxided from the Polytrope 
Solutions Web site: <http://www.polytrope.com/madechrevie^ 

Whai' rm HEOt Ls It? How Dof.s It Work? 
liisso inhabits the nebulous realm of ""middleware” with 
comjxlitors such as Tango, ASP and Cold Fusion* 

If ail you want to do is pi]hli.sh a fairly .static produa list (for 
example, a re*staurant menu), you can format it in a word 
processor and print it out; to publish it online, you can ptiur die 


William Poner l.s itie owner of IVjIytrope Solutions, a firm in Ikxusum, Texas, specializing In custom database and Weh- 
a|)pIicaiiorLs development using FileMaker Pro anrJ I.asstj. A member of die XXII Group, an inlemational ronsoriiurn of Web 
developers. Will is currently working on a site designed to help new' users of lasso over tlie initial Icaming bump: 
http: //WWW. ]x>lytro|X‘,coin/le;imingIas5o. You can reach him by sending e-inail to witl@polyiropc.com. 
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ckiii into an I ri’ML talkie, Brow.ners can interpret (and even search) 
HTML tables directly, without die assistance of any other software. 

But static lists are wurtliless when the data change frequendy, 
when die data aa* diverse and complicated, when you want to lie 
alile to search quickly through a lot of data, and especially when 
you want lo really do something with the data, suclj as make a 
sale or allow users to calendar events (inline. (On doing the latter 
widi Lasso, see Seth Ganahfs article in the September 1999 issue 
of MacTeeb.) Then you need a database management system 
(DBMS) such as FileMaker Pro or Microsoft Access, to nuinipuLite 
die dan. And if you want to make your dataliase available on the 
Web, you will need a middleware Icxil .such as Usso. Neillier the 
browser on the client machine nor the Web-server afiplication (for 
example, WebTEN or WebSTAR) on the Web server can direilly 
communicate with or manipulate the database or data source. 
Serving as the inlcrniediary between the Web server application 
and the database Ls Lasso's main job. It can do several other very 
neat tricks, but this is its bread and butter. 

Lasso is a CGI or plug-in that runs in c(K>peration with your 
Well server software. It comes in two distina flavors^ FileMaker 
Pro and ODBC At the risk of staling the obvious, I will point out 
that, to communicate with ODBC data sources, Lasso uses 
ODBC. Wiiii FileMaker databases, on the oiher hand, Lasso can 
communicate in a couple different ways. On a Mac server, Las.so 
normitUy talks to FileMaker databases using Apple Events. Linder 
Windows, Lasso communicates with the Web Companion using 
ilie FM Remote data source mtxlule, wliich comes with Ijisso. 
(This can also be used on a Mac and is particularly useful if you 
are doing cross-platform development. Tlie FM Remote cLta 
source [iiodule lias some limiiations which make ii difficult or 
im[Xissible to do certain tilings easily done with AfipleEvents.) 
Note: FileMaker Pro 5 has just arrived with level-l ODBC 
compliance, whidi gives read-only access to FileMaker Pro 5 
(standard edition) using Lasso's ODBC module. 

Devf.ix)pin(; Wnii Lasso 

Regardless of the differences in how^ it talks to tlie data 
source, Lassti Ls a remarkably consistent cro.ss-platform tool. You 
can move your solutions from platform 10 platform with few or 
no changes, and it i.s easy to develop on one platfonn for 
deployment on tlie oilier. Lasso's only major platfonn drawback 
is that it will not work on UNIX or Linux servers. 

Lasso is properly speaking not a development kkiI. In fact, 
technic:ally, you do ncX need to own Lt-sso to devdo[i LasscKlriven 
sites. (In tills it is differeni from a product such as 'Fango, which 
requires you tuse its pmprietary development tcx)l.) A Llsso 
developeFs pnxlucl or output is simply a set of Well pages to which 
LDML (Lasso Dynamic Markup language) axle has been added. 

In the past, WYSIWYG HTML editors .such as Adolie Golive 
and Macromedia Dreamweaver have had a tendency to munge 
Llsso ccxJc, so most Lasso developers have relied on text editors 
such as Bare Bones Software's DBEdit, to code their pages. But 
life Ls getting better for developers who would like to work in a 
WY.SIWYG environment. Recent releases of Lasso have provided 
ilie option of ccxiing using the “objea syntax method,” a slightly 


different way of formulating Lasso tags within anglecLbrackcts that 
HTML editors Find more palatable than the .s(|uarc* brackets used 
frexjucnLly l>y LDML, And by the lime tills article appears in prim, 
tlie Lasso Studio for Dreamweaver will liave lieen rele^rsed. Hiis 
promises to lie a major Ixmefit to developers, who up until now 
have suffered from an cxrcupational hazard iliai I call the “Lis^so 
headaclic%” brought on as a result of the intense concentration 
required to find and understand Lasso cxxle tliat is lloating here 
and there in a sc^a of IflML that may Ik^ tjuiie complex. 

While you can write Llsso ctxle for free, you can'i lesi it. To 
te.st your Lasso solutions effectively, your deveIo])ment 
environment must include (I) Web .server software, (2) the Lisso 
Web r>ata Engine, c<x>perating with the Web server software as 
a CGI or plug-in, (3) the DBMS that runs ycxir ilatabases, such as 
FileMaker Pro. Finally, (4) you will need to use a browser .such 
xs Nc'Lscape to view the site you have created. 

How many physical machines your development 
environment usc‘s Ls u]> to you* Lisso must lx? installed on the Web 
.server, but you could put the databases on a second machine (for 
example, one mnning FileMaker Server) and run your lesis from 
a browser on a third machine. What most develojxrs do, 
however, is use a single machine, vvhicli ads as both server and 
client. Tlie Lasso Developer Edition, a package inirtKliiced wiili 
the release of liisso 3.5, provides all the Lasso data stnirce 
modules, in case you already have a Web server to work with; and 
if you don't, the DeveloptT Edition also provides a special liinitecU 
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dccvss vtfrslon ot rJie Lasso Web Server. The Developer Edition 
version of liie liisso Server limits you to two concurrent 
conneaions to the database, bui this Ls enough for you to develop 
and test f>n your own niacliine and to enable your client to access 
your development server over the Internet and view the site's 
piogress. (The un!iniited-a<:ces.s version of the Ltsso Web Server, 
available only for the Mac OS, while not nearly as multi-faceted 
an ap[iJiotion as WebS'lAR, is an economicaf and reasonable 
choice if you will only lx; serving H'LML and LasM) pages.) 

The single biggest pit)i>lein for new Uisso develo^KTS is 
figuring Lis-so out sutficiently to get tlial first site finished. Blue 
World provides no slcp-by-step tutoiial that takes you by the hand 
through tlie prexess of iasiallaiion arKl into devek)pment, and ilie 
Reference Manual, while tht)r(jugh, is addressed more to 
experienced develoix-rs than tf) lx;ginneis. On Lite otlier liand, one 
of the greatest things about Lisso is that it is possible for a 
developer to learn a little l>it and do stmiething w'ith it, where witli 
many of die alternatives such MicR>soffs ASP (Atiive Sem^r Pages), 
you have to learn quite a k)( Ix^fore you am dca anything at all. 

lASSO Performajnci- 

FileMaker 5 Unlimited adds a couple nice features to the 
Web awareness built into FileMaker 4.x, sucli as the ability to 
display your FileMaker layouts tin tlie Web di redly tising XML. 
and support ftjr distributed database serving. Nevertheless, bisso 
remains the ttnil of ciioice for building Web applic^iUions artnmd 
FileMaker databases, for two reasons: first, because us a 
programming uxil, I.DMl. eats CUML's lunch; and second, 
Ixrause Utsso is multi-Utreaded and FileMaker 5 (alas) is not. 

A Laxso-tlriven site alUxales the different tusks to different 
applications: die Web .server serves up HTML page, J^tsso talks 
to the database, and the DMBS responds to Lissos re(|ue,sts. 
While the Web seiv'er serves pages and FileMaker Is processing 
a single rccjiiesi, lasso may lie very busy. It.s right hand 
prexesses and cfueues up requests to be sent to the database, 
w'hile its left liand converts data received from laleMaker inUi 
HTML t^itgt,‘s formatted on the lly, and scmcLs those DHTML 
pages hack to tlie server. FileMaker may ultimately lx* the boss, 
hut bis.so is a dream administrative assistant, getting everylliing 
as ready as possible Ix'fbre putting it on the lx).s.s s desk. A site 
run by the Web Companion alone, on the other hand, is like an 
office in which the Ixjss has no secretiry. He has to answer his 
own phone, type* his own letters, and do his own photexopying 
— and he can only do one thing at a time. 

I hasten to mention that people who only think of Usso as 
a Uk)I for serving up FileMaker daial>iisc‘s tend to think tliat Lisso 
is only appropriate to sites with no more than modecitely heavy 
tniffic. This is not tlie case. The bottleneck is FileMaker, nor 
Li.sso, On a fast server, accessing a iniilti-thR^aded ODBC data 
source. Lasso is capable of handling heavy traffic graceluily. (A 
white pajxr comparing Las.so to ASP was prejxired liy ASP 
develper Jo.sh Ikxiver and published in Oc!olx?r; it can lx 
downlcxided from Blue World's Web site. The gist of rhe report is 
tliat Lasso runs faster for most tasks, uses fewer lines of ccxie to 


gel the job done, has the advantage over ASP in flexibility and 
exteasibiiity, is aisicr to get into, and is coasidenibly mote 
secure.) Real .sUUisiic:s are hard to come by, and there are other 
factors to coasider as well, but such a site could probably deal 
wilii liundreds of thousands of Lasso/databaxe request.s a clay. In 
other worIs, kisso is a serious commerciaLgrade tool. 

EXAMPI.F. Problem: An Onione STiii>Fm' Directorv 

You have Ixen asked to pul online an elemenLrry schcxil's 
student directory. T!ie scIxkiI acxxsse.s thLs directory internally over 
iLs IAN, and the recnids for studcnls will lx created by school .staff. 
Over the Wei), ttie school w'ould tike jxtrenls or students to lx able 
to upekite (Ixit tiot create or delete) their child’s rec^J^d. PassworcLs 
will be mailed to parents for this purpose; only someone w1k> 
kitows the “pas.swoiTr' asscxlated willt a reaird will be able to edit 
it. Parents should al,so lx able to aintiol whetlier lltcir child’s record 
is viewed online, and il^ it Ls, how muc h of the data Ls public. What 
is involved in buiklijig the site? 

Notice fust that .siime of the tilings that tlie school wanes will be 
done Ixsf in the database. Tlie first step to building a gocxl Lasso 
site Ls knowledge of the database syj^cni you are datling with. Each 
record in tliis diilalsase needs to have a field makepublic which, il 
checked, indicates tliai tlx record may lx jxiblLsixd online. 
Additionally, every signifiamt daui Held such as phone must be 
comjilenxiUcd i>y iwo other fields, a |xnnisf>ions field (phonepublic) 
and a ailcukiiion field tphonecalc). Using HleMaker, tlx* formula for 
the field phonecalc would lx*: 

tr (phonepubiic ^ “y", phone, 

G(xxl database design is an important part of die Web- 
[3ui))ishing pr(xes.s for other teasons. In theory, Lasso can take 
just alxiul any database that works and jxibltsh it on the Web. 
Bui in pradice, the KISS principle applies here in spades. 
Simple, efficient database design will make your site run more 
quickly and more reliably. 

Okay, so you have finished writing the database 
(directory.fp3). You have the Lasso Developer Edition 
installed on your emm computer and properly configured, 
ami with your DSL connection, you have a relatively stable 
IP address that you can connect to from the copy of Netscape 
that you use on that same machine. FileMaker Ls running the 
databa.se in the background. You are now ready to write the 
pages that wall make up this simple site. We are going to use 
five pages, as shown in Figure 1. (This site stmcnire is not 
only simpler than the one I would use in reality, it al.so 
possesses some security problems that we will look at.) 
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fyfiire /, Stmciure of the Stuckml Din^Ltor}^ Site. 


The starting page 

*lTie stittiiig or home (xtgc hu.s mo singlc’llckl .search luniis 
on It One tlekl ran l>e used liy luiyonc, U> sain'Ii for siudents by 
name or year ol gratluation, I Ills is iJie form one cliild will um* io 
fmcl another s phone numlxT, Tire oiher fonn ha.s f>nly one search 
fiekf which an<jws siiidents tor iheir parenis) fo search for their 
own rmjrds only, by jxiaswiad. The passwi>rd is ac iually nothing 
more than a ynit|ue string entered in a held called password in each 
record. If propc^rly axled, this sL^tieti will result in (at most) one 
record Ix-ing Ibund, the rcTord tliai the liser is auiliorizt'd to edit. 

The public student list 

If the public-access search prcxiuces resulLs, tliis jxjge will 
display theng in a list. Typically, hit lists of this tyfX! are 
formatted as H TML tables, one row of which is marked for use* 
over and over again as many times as needed to accontmcxlate 
the nuinlxT of records found. In addition, this list might dis[>lay 
some simple information such as each studeni\s first name, claxs 
rank, and telephone numl>er (prtivkled that tfiese fields have 
Ix^en marked to fKTmir display), hinally, each students name 
will !x^ formatted as an href link attaining a liit of Lasse j cexie, 
so that il the u.ser click's on that student's name, the browser will 
load the detail page for that siiKlent’s record. 

The public detail page 

This page wall tlisplay tor a single student rc<'ord all ihe (iata 
that have been marked for public display. 

The private update page 

lliis is sititply a h>rm shf)wtng aU the data-enity' Oekl.s for a 
student's own record, with the current values inseiied inu> 
editable lexi rtelds. When the subiiiii button is clicked, any 
changes made by ilie user wall lx made in the database, and the 
user will lx taken to ilte detail page. It is not necessiiry to worry 
about whether cbtta is authorized for publication or not on this 


page, l>ec‘uuse tlie student is viewing his own data. Other thati 
the tmoer of the record, only die scIkkjI staff, who access this 
database via their internal LAN, are able to view all of tJiis data. 
But they are viewing the database directly in FileMaker Pro. not 
in brow^seis on an intranet. 

'iTie no-recordS'found page 

This page will be seen only if a sixm'h finds no results. It 
contains a simple sfcitement advising tlie user djat no reixxxls were 
found niiUching Lite se*atx:h criteria enteted and giving the user llie 
chance to go Ixtck and try the search again, or go somewhete else. 

Two Different Ways m Code 'rHF.SE Pages 
lasso offers the develofxr two completely different ways to 
eexJe pages: using the traditional tags or using miines. I^ec'ause tlie 
traditional Uigs resemble m’ML in form and function and require 
less thought to use dien inline^, devekipers learning Lasso are 
templed to rely upon tlieni exclusively. Bui iliey pcxse a variety of 
security risks to yotrr Web site. Although traditional lags and 
inlines can lx mixed, most ,serious developers u.se die inline tag 
almcxsi exclusively, in large pan lxaiu.se il us more secure. 

rraditional Lasso tags 

Originally, Lasso ]>ages relied a great deal on ordinary 
HTML For example, die f'onii on the first (>agc of tlii.s site 
tstiidentdirectory.hiiiil) which you would use to find other 
siirclents by last name might be coded like this: 

<fom actlon^"attion. Iflfjso" 

<input tvpe=”hidderi'' imntc''"'* database’' 
value=”dl rectory, f p3 '*> 

<input type^'hidden*' nante=" vlayout" vaiue-^seardCb 
typ(?="hidden'' name^'* response’* 
va1iie-"liBt-htnl "> 

<Input type^’*hidden“ naiae-^** nuresiritcerror" 
value^^oothingfound .htm ]O 
^input type^’*bidden'* namc*'^“iiiakDpublic“ value“**yes"> 

< input Type=''hidden** namp-’' sort field" value-** Is stName") 

<p>Enter the last tmm*: nud/or graduating year of the 
student you wish to £ind:</p> 

<p><inpin Lype="text" nane^^iastfiaiiie'’ value^"" 

GSKe-‘*25"></p> 

CpXinput type^^text" name='*clann** value="" Bize^"10‘*></p> 

^ input type^**3111)11111" name=''’ Search*’ voIue^"E>earch"> 

</fonji> 

Tills axle is jusl standurd 11 I'M L with Lasso specified as the 
all ("action - action Jasso"). It gets the job done. 11 tells Li,s,so 
what do do— what database to search and on what layout to 
kxik for tile llekls to searcli in. what file to use to foniiitt ilie 
results, arxi so on. Note that it also adds a search CTiterion here: 
the value in the field makepublic must = “yes." 

But there is a signihcjint prolilem waih this fonn. It gives 
everything away. Any curious user can view* this informiition by 
using his brow.ser's View Source command. A clever student — 
esjxcially one who knows just a little about Lasso or CDMi 
(.since this is also how- the CDML works in the Web Companion) 
— may lx able to glean from iliesc clues enough information to 
Itack mlo the database. With this sort t>f inlomiation, for 
example, a stirdent could create a CGl search string, designed to 
find another student, for exainjilc: 
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action.]3330? 

databaE;e=directory. tp3& 

- layout^searchil 
■ respoixse^list. htmi& 
makepyblic-noi 
*findall 

If the Itackcf ty(xxi tliis axJc into the brow.sers location Reid 
(nin together on llie sitme line), then hit Return, he would Ik^ 
rewardt-ii with a list of jill of tjie rettirds lo which public access wits 
sTjptxised to lx,* denied. And tlie link m the detail p;ige from these 
records wcxikl sliow him any details lliat ilic ixtrenLs, thinking the 
entire ax^oixJ was ofFdiniits, had not lx>rhered to deny access to. With 
a little more ingenuity, the ban ker axild fxisstbly gain acceSvS to the 
u|xlate jxtge and actually nxxlify ilie data in a rc'cord tliat he was not 
even s^ippfxsed to Lx" able to view. 

Now you t:iii take some comfort in the fact tiiat wliat a liacker 
can do is limited by die fXTinLssioas given to all ttscfrs in lasso 
setiiriry, which we will discuss In a minute. If all users are luX i)y 
default rxH allowtxJ to tlelete records, dien even a projieriy 
R>rmulated string uMniiiaiKling Ll\so uj delete a terrain vtxxml will 
fail to lx eKecuied. But tHjr example site does allow' users l>y default 
to utxtite Rjct)rds, and ii relies uprm the design of the site to restrict 
users to viewing only recoids whicii llx record t>wmer lias permitted 
to lx viewed, ^irrd to iipdaing, diat Ls, editing, dicir own rcctjrds. A.s 
we have .seen, ihis reliant^* is ilUadvised. 

Knlines: 11 ie better way 

Saiiriiy is alw'ays a iTiultidinxnsional uisk. Server security, Us.so 
security, and good site design all play a pan. Hut as we txive jitst 
seen, it tkxs no gtxxi to kxk die dtx>r if ycxi leave the key in it, f)n 
die ouLsidcl One of the most important things you can do to keep 
your site and your daui secure is lo c*ode this site entirely diHerendy, 
iLsing Litsso's more secure iriiim li*gs. Actually, Ixsides Ixing more 
secure, inlines have many exher adcaitages over traditional lags. To 
Uike full adviinlage of inlinc^s, it Ls necessiiry to learn alx>ut some of 
Lasso s other tags, such as token and form paiam, Ixxli ol whkh allow 
form pirameitMS tf) lx passcxl ftom one Web page lo the next as if 
they wcTe .stored in short livcxi variables. 

the secTet of die inline lies mX in its syntax, which Ls not ail diat 
dilTereni from the syntax of dx traditional lags — just dilTcTcnt 
enough, many Lasso asers wmdd .say, to lx iumoying! But while 
traditional tags weie stoivd in one fxige (die pie-Lasso page) and the 
resulLs they gtwmtcxl showed up in another page (die JXJSL-Iiisso 
page), inlincs am storexi in the very file that will lx used to package 
die results of the acdon or actions diat dicy specify. When a p^lge 
cxintains inline^, it typically Ls saved witli tlie Fdenamc .sulTtx kisso, 
which tells die Web .server to li^ind pRxx^ssing of the page to Lasso 
first. ('HiLs Ls not .stricily rux.c'ssary. You could exmfigure ytxir Web 
server’s Rle-sulilx .settings .so tlxit the Web server would al,so liand 
.hun or Jilml page’s to Llsso firsi, but this would me:in that Ltsso 
wcxild lx asked to kx>k at a kx of pjiges dial had no lu.sso txxie in 
them at all.) 

IxFs look back at the ccxling of the search on the First page 
of OUT .site for students by name or tia.ss. We can’t get around 
the need to create a form on the main page. After all, the user 
has to have a field in which to type the name of the student he 
wishes to find. But the fonn am Ix" coded so that it reveals veiy 
little inlbniiation alx>ut the datalxisc, like this: 


<torjn action^’iist^la^so" method”"post") 

<p>Ent6r the naae and/or graduating of rhe student yon 

wish to find;</p> 

<p>Ciiiput type'^^texf name""!" vatne""" 3l3je””2!i"></p> 

<p>(input naiiie”“2" value”**** 3ize=**10**)</p> 

<Input typc="subiiilt" NAHH=** nothing'" VALUE^"Search"> 

(/form) 

Here, die HTML source code reveals nodiing alxiut the 
database al all. Rven the names of the fields ixing searched are 
disguised a.s arfiiirary and meaningless numlxrs. 'this form does 
not even trigger a search. It dexs only two things: it captures the 
cLiui tyfxd into the fomi fields and stores it as fonn parameters 
named "1" and *‘2," and it hands thex fomi parameters to the file 
list.lasso, which is specified as the action parameter for the form. 

'ihe following code is placed on tlie tesjxinse j>age (lisl.lasso): 

tinilne; database^*directory.fpJ', layout-'gearch*, 
■iDak&public*”'yes', *studentfiaiues' = (form param: ‘I'), 

*claES' = (forBt.parani: *2’), uortf lpld"*la3tiintne', 
nOfeaultserror=*nDthingfoUTid .htral *. search] 

<™lThe data-display part of the page goes here-) 

[/iniinel 

Ttie sejifcli srringfs) entered liy the user are [xissed to this inline 
as fomi piiraiiieter values with ific names *V and ITiis inline 
coininand tells Lasso everytliing dial die Lradilional fonn eexie used 
trarlier Told ir, but this time it telLs Las'^o only, Hie iastruction in tlie 
inline Ls [inxesscxl by Lasso, and once pnxessed, it disappears. It 
will not lx passed to tlie browser, not even as source ccxJe. The user 
will see only the results — a iLst of students — not the code used to 
[iRxiuce tliose results. 

JTie student list 

Now lei’s add tfie crxle necessary to display the list of 
.students found by the searclt. Even if the user searches by last 
name, more than one rectird may be retrieved, and of course, if 
the user searches by graduating class alone, a large numlxr of 
records will lx relumed. So it truikes sense initially to di.splay the 
records found in a fist, 'ihe code for the list is usually placed 
iaside an FFTML table. One row f>f the table gives column (field) 
titles. Another row- is marked with the lasst) [records] tag, which 
tells Lasso to reuse the formatting in this row as many limes as 
necessary. Tlie table Itxjks like this; 

<tahlc> 

<tr><td>Nums;</t(l><td>Ciass</t<l><td>phone</td></tt> 

[records) 

<tr><td> [field: * Etudentname*1</td> 

<td> [field: 'clasEcalc'l </t<!> 

<td) [field; ■phonecalc*1</td></tr> 

[/recordsl 

</T.ahle> 

If Lisso finds at least otie smdeni whoise last name is 
"Rcxisevelt," it will fetch the data for each student’s record from the 
diree fields sixeified in the table (studentname, class and phone), and 
will substiUite the data for tlie Lisso field tags slitjwn alxive. The 
user Will .see a nicely formatted list of smdenls named Ktxisevelt, and 
if ilie uscT invokes die bftiwser’s Show Sourxe command, iustead of 
seeing tlie code above, he wiR see sonxtliing like diis: 

<tr> 

<td>Franklin ROOSEVELT</td> 

<td>2a02</td> 

<td>7n-444 l943</td> 

</tr> 
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Lasso has generated the actual HTiVIL far the page on the 
fly, l)y packaging ilie data found in the m;inn€r directed by the 
resporise page. 

A weakness of tiilines 

Wliat Ls missing from the code above is a way to get fn >m the 
list, wliich displays only a little bit of information alxjut tlie student, 
to the full details for iliat student Lassti 3.5 only provides one easy 
way to do that, u.smg a detail link. Here is die previous ctxle with 
tlie detail link added: 

<td>CA HREF^"lL±nk_Oett«il: LEiyout='delaJl', 

Response^' detail. htail * p> 

[Field: ‘namefirflt'l [field: 'namelast'J^/AX/td) 

Tfiis says diat, if stimeone clicks on a given student's name in 
the list, Lasso should refer to the dauihase layout named detail and 
load the page “detail.html.” But tlieie is a piohltm here, once again. 
The I^s.so lag [link_ctetajl] is processed and converted into a standard 
href link by Lasso, so when this page is serv'ed up to the user and 
the user looks at the source ccxle, he will set^ somdliing like this: 

<tdKA ttRKF=“list .lasHo? daLabase^dlrecLory.fpl 
& -1 ayout^etai ‘ re spons eta i 1. h tmllt - tec 11>=5 

&-search“>lField: 'naraetirst’J tfieid: *naaielasi;']</A></id> 

In Other words, everytliing we tried .so hard to keep hi<ltk"n 
earlier is being revealed anyway. I can he^tr yrni saying already, ""So 
use an inline!" GrxxJ. You arc catcliing on. UnJortunately, in this 
case, dierc Is no ready alternative. Inhnes are still .somewixtt new, 
and Blue VCbrld lias not yet ii;id a chance to tlo a cornprtrhc.‘rLsive 
overhaul of the l.as^> tag library to make it cusy to do everything in 
inlines. Ibe only tiling ycxi can do is a sort ol workaround. It's not 
in tile dtxnjmentation—which in fact never discusses the tlifterentres 
between the traditional Lasso tags and inline’s—and it's lairdly 
olivious, c-spccially to Ixjginneni, Here it is. On llic student list pitge, 
tile ccxJe alxive would lie replaced by this cotie: 

(tdXa bref^“detail.lasso?'token.IIX[field: 

[field: 'fltudeni:iiflBiB'l</A></td> 

'Ihe n^ime of the response p^ige (now “dc-taillasstD (us to Ix! 
revealed, and the value in tlie ft) field will also lx? levealed, so it is 
a gtKxl idea to kc^ it meaningless. But there isn't much tlial even 
a clever hacker can do with that little. Noik’c here that tire Lasw> 
atiitm -nothing is u.sed, liecause die href lag iLsclf is not really doing 
anytliing excc'jX creating the token and c'alling the respon.se page. 

Ihe rest of die work i.s dtine in the response page, whith kx iks 
like this. This time we will kxik at die HTML for die entiie fUge. 

1inline: database^'ditecLory.fp3’, layout^"dota \]\ 

’ ID' “ (token_valu e; * ID'), st*D rcb ] 

<HTML> 

<HEAD> 

CTITLE>Detall</TITLE> 

C/tfFAD> 

<BODY> 

<p>[field: *situdi?iiLnaiBc’]</p> 

<p>{field: *5treetcalc’l</p> 

<p> [field: 'city*], [field: 'state"]</p> 

<p>[field: ‘phonecaic * j ^Ap> 

<p>[field; ‘classcalc*J</p> 

</BODY> 

[/inline] 


Tile inline scafches in tlie ID field for die value passed by the 
tokcai, then cT:eates the H'l'Ml [xige tixit displays it llliiniately no 
infomiiition is revealed about die cbttalxisc at ail. 

As for die ufxJaie jxigcN *1 i^i^iy enough liefe for me to 
coimiicnt that it is Lusically an HfML, but its fields have fjcen 
populated with dita from the fount! wlieri die user searched 

for their password Tlie fields in die axJe for die fonn ate given non- 
revealing siring identifiers once again, e.g,, 

(input type="tea±“ Value""'*[field: 'namelast*] 

When die user clieks on the Update button on the form, die 
form pammeters ate captured, the page delaiLlas,s(s is called, and an 
inline in dial file dcx?s the actual pnxrssing of die Li[xbte. 

Other strengths of inlines 

I mentioned orlier ifiai inlines (lave otlier advantages tiesides 
being more seeure dian traditional tags. Tliey cun, for example, be 
nested vvitiiin one anodier, meaning diar ytni can ask Lasso to 
perform nxxe than one atlion or reference more dian one diitdxise 
on the same page — .somediing not possilile widi die 
Coiiijxinion. Using nested inlines ycxi can acuuilly achieve resulLs 
that look like they derive from relationships in die daialxLses, even 
if no .such relationships exist. There is almost nothing tkit Lasso can 
do that cannot lx* done with inlines, and then* i.sn’t much that inline’s 
cannot do. 

Perhaps Lieaiiise Idue Worid dtx’s not want to suggest to users 
who buill sites in Lasso [irior to the intuKluttion of inlines ksi year 
dmt dieir sites are not sec'uie, die Lasso ikx'umentation nowliere 
expnisses a preference for the inline over die traditional tags. It 
should. If you dexitie to leant to develoji with Lasso, ignore the 
Lradiiiorad mgs and leant how to ccxle your site entirely with inlines 
riglit from the start. 

Going Blyond the Qinvtjntionai. Omine Dataka.se 

\)t1ien they think of Welvenafiled databases, most users think 
of conventional lists of daa that have simply Ixen made available 
online: library catalogues, [irodua and pricing lists, schcxil 
negistradon systems, cdencbirs of upcoming cvenLs, and die like. But 
as a Webpnigrammtng language, Ltsso is so flexible and so 
powerful dial it can lx? used to build tnily dynamic Web sites, sites 
in wliich die database is not a jxiit but tin* whole. 

One of my own cirly bisso projects invoivcxi converting a static 
site for die staliles where rny tiaugliter rides 
httpiZ/MAiywherrmnopailc^^ to a moR’ dynamic ckitabase- 

driven .site. 'Ihe site servt^ a variety of infonuaiiorial [luqxjses, bin 
mcisdy, ifs a newsletter for the stables, announcing upcoming 
events, or reporting on the results of axent horse shows, bird is at 
the stables, and so on. A simple flal-file dalabise stoics icfereace 
information on the articJc’s, including article title and date, and the 
pathname on die .serv'er to tlie include file di:it contains the actual 
article, A Lasso indude file is nothing nx>ne than a text file, usually 
a snippet of LTllvib that Ls insc’ried into the shell for a web page 
pnjvidcxl by some odicr HTML file, I dicxse to use includes, ratiier 
tbin simply serve up text faim a field in the data, Ixxiiusc indudc*s 
allow me to format the ank’les mom fully—to create a talile to report 
riders' rcsulLs from a shew in one article, or to add href links to 
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anodiLT, and graphics to a thiniL Hit! main pagt? of the site 
aLitomatically dLsj>lays ilie latest news article avaihiblc, wl iich mcims 
that ii is not necessary to do tlie cutting and pasting tlwt we used Ef> 
do. And ix!caLLse tlie site is built an^und a database, it is very easy 
ft> update (I don’t liave to create an actual new HTML (xige) and past 
artk'les are archived and scardial>le. 

So far this i.s trivially sinipk*. TIic next step tn this slow-moving 
project will lyc to add a couple of cbtabascs that make 
personalization of tlic site possible. For ex;jmp!e^ would like to 
add a c’ouple dbitabases to tlie site: t>nc for horses (with pictures, of 
ct>urse, whicli Law) c:;in handle nicely), and one for upcximing 
events. Visitors to tlic site wouki lie encouraged to define their 
preferences: Who is your favorite liorse? What sort of upconiing 
events are* you panktilariy interested Tliis is simply a more modest 
version of perstmli/eti portals such as My Yahex)! Tlie preferefH:es 
tx)uld lie stored in a cookie set on the client madiine. Such a site 
requites .some fiiirly intelligent axiing (and a little nxire time than 1 
liave hiid to volunteer), hut lasso is more than up io tlie task. 

In faa, Ltsso ran do a lot to enliancre a site tliat does na involve 
any dalaliase whatever. An<xher elieni, a finn tliat pirx^esses healtli- 
cire daims, wanted tlicir own clients to lie able to sulxnit information 
to them using a Web fonn. Tlic informarionj after lieing submitted t>n 
tlic Web, gets mailed to my dienfs oflke. Rut after the user dicks on 
the submit button and betbre the infoniiation gels emailed, bisso 
massages the dam in some ways that make it much more useful to 
my diem. Using Lasso, 1 was able to get tlie job clone quickly and in 
a way dial Is completely reliable. And this does not begin to push 
hi.sso to its liiniLs. Uisso's support for advanced technologies such as 
XMh .server-side Java^kript and Java, and its ability to work not just 
witli FileMaker Fni hut with any ODBCxompliant dam sextree, meiin 
that Lisso is much t>r an appliationdevelqitiient t(X>! Uian the 
prcxluci name “Web Data Engine” ,sex!ms lo suggest. 

lAsso SEanny 

Once contigured properly, Iilsso seiiiriiy is very robust. Bui it 
Otn lx? a [jain in the neck to set up, partly lx'cau.se the Wb interface 
used for configuring Lasso i.s conhising, and partly Ix'caasc- ilie liisso 
dixtJinenmtioo is sketchy and ex>nfusing. 

Hie semen shex here gives a paftty gcxxl idea of what Lasso's 
smjriiy configuration pages are like. What, one wonders, is the 
difference toween die two links al the Lxxfom of die page, “Laxso 
Scx’uriiy” and ‘^Security Settings”? No way to find out liut to dick on 
die links and .see (and even then the difTerence won't be clear at 
first). F'lsevvhere, die configuration pages lead you down dead-ends, 
forcing you to hit the Kick Ixitton to escape. Hie same sort of 
a)afusian can found in chapter 13 of die Rcferem-e manual, 
which deals widi security, for example, ''Hie Lasso security default 
fiagc i.s divided into four sections: Database Administration, Add 
New Daialxise, Users Administnition and Glolial Administration.’' 
The lx?ginner may wonder why adding a new datalxcsc docs not fall 
under the heading of “ckitaKasc administratkin." 
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Lasso Security Actmtnisiratjon :^ Detail 


User Permissions 


User Name: |*ll Ibrn 

User Permlssjees: LJ 
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Figure Z A safn{>le of the Ijm) secutify pag&, 

Confi^rin^? Lasso security Is first a matter of dctemilning what 
you will allow “all u.sers” (meaning anyone) to do with “all 
databases.'* One expetis UiLs lo lx? a default, !xit it Is not. Rather, k 
Is an inevcx:jihlc riiiniiiiuin. Say you tise the .setting sliown in Figure 
2, which gives all users permission to sc^aft h datalrases. You will nrs 
lx able to override t>r eliminate that privilege with a pjirlieular 
datal:>ase, 'Hie only tiling you can do for specific datai)iLSes Is give 
specific: users ackiittonal privileges. If security is a concern for you 
or your client at all. tliere are likely to lx ditalxises tlxit you d(j nol 
want to let people even seaa'h. This ine;ins that the only iciilly guKl 
way to configute Lasso security Ls to give all users no privik'ges 
whatever, tlien to assign sptftific privileges to inclividiial usefx, one 
dauilyase at a lime. 

And there Is an odd security risk with the standiird inseillaticjn 
of Uisso. By default, Lasso installs its lx >nllgiiration files in a folder at 
tlie domain's Rxit. This nxans iliat typically, anybexly with a 
bR)w.ser and Web access can get to your Uisso configuralitm fiages 
by going lo <htfa://www.yourserver.CQm/lasso>. Ilicre, they c'an use the 
lustant Web Publishing feature lo view the iximes of all (T the 
diitatxcses that riLs.so can talk to. And fnim there, if all usc‘rs have 
been grantcxl “.search'' aci^s (the faitory default), these very nosey 
people may Ix" aWe to iLse Tn.stant Wei) Publishing to fx?Ri.se tlie data 
in the personnel datalxcse that nolx>dy expal.s you to have access 
at all. The solution Ls .simple: move the folder named 
“InstanlPubllshing" exit of the lasso folder. One hopes tlxit the next 
release of La.ss(> closes ifiis .SL'curity hole. 

These (juirks aside, Lisso security is light Lind fimi, and 
a)mplements ycxir Wh .servers .scxurily settings intelligently. Ycxi 
can lock ycxir dita down pR.‘Cty well, L>y conttolling useis. and by 
limiting access to specific datLilxiscs and to specific fields, even to 
,sjxx:ific diiettories on tlie server 

OEAiJivti wmi Errors (iNCLUDiNCi Your Own) 

La,sso dcwelofinient tends to involve a lot of trial and error, for 
experienced users as well a.s Ixginners. Lim> is nor C+-^ and can lx 
leameil, if ncx masiered, by a detemiined newex^mer within a 
relatively short time. But. the development of your first site or two 
will almost certainly involve some frustnition. Even if ifie 
dexumentation were IxLler, it would .still lx a challenge sometimes 
to track down tlx source of a ]in)blem, becxiu.se it can lie in so many 
places: server pRiblans, las.so ccxling tiroJileius, IflMl faults, 
FileMaker pR)lilems, and so on. Fortunately^ the new tag piirser and 


llie debug module, new in Lasso 3.5^ give you fecxlback that gpes 
Ix^ond an error axle. 

MexsL IxginncTX make the sjime mistakes: Lasso Is ncX properly 
installed or configured; l.DMT. cxxJe contains typos; the IDMT. cxxle 
refers to databcLses or layouts or fielcb inaaurateiy; or tlic user has 
inserted LI^ML cxxle into fault}' HTML These mistakes are sure-fire 
Llsso l)usten>. Blue Woiicl pR wides a free tliiity-cby demo of Tasso, 
and goes on to pR>vide iliirty day.s of support after your piiniiase die 
pRKiuci. Be suR.* to download and Ixgin with ilx demo hejbre you 
buy. You will want to get into the pRxJuci as far as yem can befexx: 
you buy, .so ili<u you miike tlie Ixst use of your month of support. 

As you move Ixyond the basics, you will want to take 
Lidvanlage of Lasso's gcxxl enx>r-mapping cajxtbility. Wt^lLbuili I.a.sso 
sites tell users when they have failcxi to include required data in a 
fomi; when no rexords matcliing the seaixJt criteria were found; 
when a pccssword is invalid; and when the user lacks the necessary 
level of acc’ess to the database' or a layout or a field. 

Miscojanflhs Ffatores 

My aim in this article has Ixvn to f>R)vide an intRxluaion Lo 
l-Lsst), Lind there art' nccc'SSiirily a laige number of inleniiediate and 
advanc ed topics tliat must lx left for you to investigate on your own. 
Tliese include Lisso's emuiil ttipLibiliiy; ils amazingly simple ciedit 
card validation tig; its ricfi set of tags for mardpufaiing text strings, 
dates Lind numeric values; its file nxinagc'incnt la^, wliich allow you 
to cmaie^ write to, delete, uKwe Lind mnaiix files on the server; die 
afiiliiy to cieate Lasso mat ro« (Rxtines lluit perform a task and c'an 
lx stored in one place ;md leferenced mpeaLedly); improved 
support for languages txher iliLin English, witli tlie addition of new 
enexxiing tags; support for server-side JavaScript and XMl^ and for 
advanced dcwelnpers, the liisso Java API (IJAPl), whitrh allows Java 
prognimmers lo extend Lisso's capLibilities on tlie server side. 

CONCJLISKXN 

Lis-so 3.3 is a flexible Lind powerful UmjI that many 
develo[)ei:s of Web apiilicitfons would find a useful addition to 
their ttxil Ixix. Once you get over the initial learning bump, Lasso 
sites can be pnxiuced relatively c|uickly, and lasso's support for 
botli Window-s and Mac OS, Lind its ability to work with any 
ODBC-compliant data source, make it an ideal tool for 
prcKotyptng large siic-s, or for kirkling medium-sized sites icxiay 
wiih Lin L 7 e toward growth i n I lie future. 

Usen. Rfsoiikts 

There are at present no IxKiks on Lasso available, 1tte ixsi 
place to go for more infomiaiiori alxxit Lisso is to the Blue 
Woild Communications Web site and to the Lisso Solutions page 
in particular: 

<http://www.bluewofld.com/blueworld/producls/l3ssosolutions.html>. You 
will also find on lilue World's site information on how' to 
subscribe to the Lasso-Talk list, an indispensable support gioup 
for Lasso developers. Ikginners sliould find it helpful to visit rny 
Learning Uisso .site: <http://www, polytrope.com/learninglasso>. For an 
excellent overview of the .subject of database,s on tlie Web which 
referx lo a numlxr of the alternatives to Lasso, see Jesse Feileds 
PatafMtse-iJritxm Web Sites (San Francisco: Moigan Kaufinunn 
PuhlLshers, Inc:., 1999). B 
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PROGRAMMER'S 

CHALLENGE 


by Boh Boomtra, Westford, MA 


Costas Arrays 

A Costas array of order N in an NxN 
array of Is and Os satisfying two 
coastrainLs. First, the array must liave 
exactly N Is and N*(N-i) Os, with exactly 
one 1 in each row and t^okimn. Seccjnd, nf> 
two lines I k‘ tween pain> of Is may have 
exactly the same length and ihv same 
slo^K^ St), for example, there are exactly 12 
Costas arrays of order 4: 


1000 

0001 

ODIO 

0010 

1000 

0001 

0010 

1000 

1000 

0100 

0001 

0100 

0001 

0010 

OlOO 

0001 

0100 

1000 

0100 

OlOEl 

0001 

1000 

QOlO 

OfiH) 

0100 

0100 

1000 

0001 

0100 

0010 

0010 

0001 

0100 

0010 

1000 

0001 

1000 

0010 

0001 

lOOD 

0010 

0100 

0001 

1000 

0010 

or 00 

OOOl 

1000 


So why would one care about Costas 
arrays? Bet:ause of the asymmetries 
imposed by tlie two constrainLs. Costas 
arrays ntake ideal waveform,^ for certain 
sensor applications, reducing ambiguity in 
interpreting radir and sonar returns. Ihe 
mathematics are interesting in other ways. 
For example, according to the CRC 
Standard Matliematic'al 'Fables, the mjmlx:r 
C(n) of Costas arrays of order n increases 
as a function of n until n==l6, after wliicli 
it decreases, at least until n==23: 


n 

an) 

n 

an) 

1 

1 

2 

2 

i 

4 

4 

12 

5 

40 

6 

116 

7 

200 

8 

444 

9 

760 

to 

2160 

11 

4368 

12 

7852 

13 

12828 

14 

17252 

15 

19612 

16 

21104 

17 

18276 

18 

15096 

19 

10240 

20 

6464 

21 

3536 

22 

2052 

23 

872 

24 

>=1 


Ihe nutiiix^r of Costas arrays of (irder 24 anti greater is tlie 
sulijecT of continuing researclr Your Challenge is to aid these 
researcliers i)y writing elficient ctxle to enumerate Costas arrays. 
Ihe prototype for the code you should write is: 

ilit defin^?d{_cplusplus) 

extern "C" [ 

^fendif 

long /* nunilH:r of ^j\s V ISnuttierateCost^n ( 

rtit n, r criumtniit* tana:>s of lirtkr n V 

long *costasAr rays f prraJtf borage for returning yom results 7 
^ /* nm r of arra>' k is in coslasArniys| k*n + r|. r.k arc orii*m 0 V 

Hf definedE_tplusplus) 

lendir 

Your EnumerateCostas routine will be asked lo enumerate 
all CosUis arrays of order n ajul return ihe results in the 
preallocated costasArrays. Eiich t:ell of an array is represented by 
one !)ir. 'Fhe bits for row r of the k Ih Costas array are to be 
returned in costasArrays[k*n + r], r=0„n-1, k>=0, The cell 
representing column c. c=0..n-1, is ilie bit in 1«c. 
EnumerateCostas must produce all valid Costas arrays, witli no 
duplicaie.s, and renim die number of arrays prcxluced* 

Testing will be constrained to arrays of <irder 32 or less. The 
winner will lx: the solution that correctly eniinieraLes the Costas 
amiys in the minimum time. 

This will lie a native PowerPC Challenge, using the laiesi 
Cotie Warrior environment. Solutions may be coded in C, C++, 
Pascal, or Java* 


TrfRRE Months Ago Winni-r 

C^>ngratuiarioas to our top two leaders in the points contest 
for finishing first and second in the Sep!einlx.T Playfair Challenge. 
Krnst Munier (Kanata, Ontario) t(K>k fust place wiih a solution 
iliai was by far die fastest, and Tom Saxton took seconti place. 

The Playfair Dec’i[)licr Challenge asked eemrestanis to decrypt 
m enctxled phm.se based on knowing the dictionary of words 
used in the message and some information alxiul how the 
enctxling is done, Enccxling Ls based on a keyword from the 
dictionaiy, which is used to create a 5x5 enccxling sulistitution 
matrix for the letieni of the alpkdxM The enccxling matrix maps 
paini of plaintext letters into pairs of encoded text* Complicating 
faaors include the faa that die letters 1' and J' are enaxied as the 
same cltarader The enccxling teclinic|ue also inserts separator 
chiiraclers ('X' or 'ZJ to separate rejieatcd lellers in a pair, in order 
to prev^ent double letters from mapping into an easily detected 
cnt-cxied letter pair. For more informal iem on die prolilem, consult 
the ScptemLier Issue of MacTech, or clieck out die online version 
at <http://www.niaaech.com/progchanenge/>. 
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Points Rank Name 


Krn.st's Kulution thoroughly analyzes the dictionary during 
the initialization phase. The SetUpDecoeders routine creates a 
Decoder matrix for each potential keyword in the dictionary, 
minus diiplicale matrices resulting from similar keywords. Tfie 
initialization of the CodeDreaker stmaure creates a set of 
linkedNodes based on the first three letters of the words in the 
dictionary. It also registers all letter tripleLs (trigmphs) that 
ocair at the beginning or the end of a dictionary word. The 
decoding routine loo[>s through all of the words in the 
dictionary, trying each of iheni as a deccxling keyword. The 
trigraphs calculated during initializ^uion are used by the 
DecodeCipher routine tt> pmne ilic dectxiing process. If 
decoding is successfiil to this point, the CodeBreakeniSpell 
routine recursively niau*hes tlie potenlially decoded text to 
dicLionaiy words. Tlie ctxJe is tx>mplicated but fast. 

I'om .Saxton's solution also analyzes the dictionary during 
initialization, creating a tree structure. It creates the dectxiing 
matrix during the dcxxxling prtx'ess, not during iniiialization. 
Turn’s word matching algorithm is recursive in concept, hut 
iterative in irnplementaLion. Overall, Tom’s solution Umk 
somewhat more than twice as long as the wanning solution. 

''nie third-platx: solution by I.ad (last name unknown) wiis 
neady as fast as the sect)nd-plat:e stilution. ft was unique in that it 
was submitted as a library rather tlian as source ccxle. Nc^rmally ilial 
would have l>een a dLscjualilication, but since* the ScptemlxT 
CliiiUenge, in keeping with tradition, allowed .solutions to l?e ccxied 
in assembly language, I decidcxl to sc'oie the results. 

The table lielow lists, for eacli of the five ,solutions 
submitted, the total execulton lime, code size, data size, and 
programming language. It alsc? indicates wliether a soluikrn 
completed all of the test cases correaly. As usual, the numlxT in 
paicmtheses after the entnini's name is the Kstal number of 
Challenge points earned in all Challenges prior to cliis one. 


Name 

Time 

l-iTors 

Code 

l>ala 

language 


(itiscc) 


Size 

Size 


Itrnsi Munier(507) 

m 

no 

8052 



Tom Saxton (118) 

1059 

no 

(im 

443 

C 

UhI 

1152 

m 

27% 

170 

Unknown 

RLdti Gupta 


no 

I1R4'1 

1919 

C+t 

K. il 

90773 

yes 

1828 

638 

C++ 


Top Cojntestan i's 

listed here are the Top C-onicstants for the IVograinmer's 
Challenge, including evtrrytjne who has accuiiiulated 10 or more 
points during the past two years. Tlie numbers below include 
points awarded over the 24 most recent contests, including 
points earned by this rnontli's entnints. 


Kank Name 


Points 


1. 

Munter, Emxi 

227 

10, 

Mallett, Jt-fl" 

20 

2. 

Saxion, Tom 

116 

11. 

Jones, Dennis 

12 

3. 

Maurer, Sebastian 

70 

12. 

Hart, Alan 

11 

4. 

Boring, Randy 

66 

13. 

He welt, Kevin 

10 

5. 

Kieken, Willeke 

31 

14. 

Murphy, ACC 

10 

6. 

Hcitiiccx'k, JG 

39 

15. 

Selengut, Jared 

10 

7* 

Shearer, Rob 

34 

16. 

Smith, Brad 

10 

8. 

Brown, Pat 

20 

17. 

StrouL, Joe 

to 

9. 

Hosietter, Mat 

20 

18. 

Varilly, Patrick 

10 


iTiere are dirt^c ways to earn points: (T) .scoring in the u>p 
5 of any Challenge, (2) being the firsi perjwjn to find a bug io a 
published winning solution or, (3) !icing the first person to 
suggest a Challenge that I use. The points you can win are: 


Ist place 

20 poinrs 

2nd place 

10 points 

3rd place 

7 points 

4ih place 

4 points 

3th place 

2 poinis 

finding bug 

2 points 

suggesting Challenge 

2 points 


Here Is Ernsts winning Playfair s^jlution: 


Playfatr.cp 

Copyright © 1999 Ernst Munter 

r 

ScpU'mber 6 . 1 W 9 . 

Sutmiission to Macltch ProgtaTOmcr's ClioUengc fw SepfcmlxT 99 ^ 
Ctjpyright © l 999 .ImstMunft'r,K^aiu. t)N,(:umida 

“Playfiiir Dedphtr'' 


Version 2 

Pitjhitm StaKwm 


tiiven a diciiooary.a ciplier text,and the encoding racihod.hrcjik die code and mnurn 
the di;cipln*ni!d plaintexi. 

SoliiUon 

My stritegy is to decode the dpkertext widv cadi fMwiitjte keyword until a plain lext 
rrsults whidi is actc|>tctl by the sped checker 

In tnitPlayfairO dx- dictionary' is scanned twice. 

Fir^, the set of dccfJtfcrs. cine ftir t^aeh is temstmeted. EJcouk- similar 

keywcjids cm rebuilt in kkrnUcat cmling matrieoi. redundant matrke«» arc dtorded 
where iJie kt ywonfls are widiin a certain distance of each other in the diclit>narj'. 

Secondly, a spell check tree is built which indexes all wonJs in the dictHHiary diai are 
distinct in the first S characters {stem), lunger words are diecked by indexing to die 
stem, and scanning ilic group of words whidi share the same stem dircetly in the 
dictionif)‘ 

tn addition, atl trigfaph,s (sequences of chars) in die dictionary wt>nJs and digraphs 
marking start and end of eacli word arc cotlected. 

tn Dec<idePtay£iii() we use each of die keywords in turn to dec-ode the cipher text 
into a tentative plain text. If during the plain tact construction any illegal trigraphs arr 
c-ncounteted. the decoding breaks off, and the next keywotd decoder is selected 

[f decoding passes the trigraph check (about 1 in 2(1 to I in SO), the text is submitted to 
the spell checker which rctursivdy tries to match the text to dictionmy words until the 
wliole plain lest has passed the check. The spell checker builds a stack of dictionary 
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'feu’ll be stuck in 
San Francisco’s heaviest trafiSc 
and loving every minute of it. 


At MACWORLD Expo SF 2000, Apple is making it easier for all developers, big and small, to have 
a space as special as their ideas. Apple Developer ConncTtion and MacTech*' Magazine present 
“Net Innovators” an exhibit at MACWORLD that showcases Internet t(fe)ls, products, and services 
for the Macintosh. MACWORLD takes place in San Francisco, January 5-8,2000. Check out the 
exhibits at the show (B(X)th 3458) and on the web at: www.netinnovaiors.com 
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indkcs nuiictiing the ftiutid words. The first successfully cht^ked pbun text is rc'njrticd 
to ihc caller by copyinp the uitlcxcd dictionary w^onds into rite fini plain totl. 


Compficitions 

Ibcft ate two sources of complicatiims for the spdl check. 

The letters *J’ and “!’ arc encoded as if tho' are the same, The decoding step always 
yields T. 'Ihc spell checker allows this aliasing with additional trcc branches (alias 
notks). Nevcnhelcss, there can be inie ambiguity which can not be resolved, For 
example the dictionsiry wmxis “jaN'' :md“10N’'cinnoi be dishngiushed. 

The encoder inserts X' (or T in some cases) if the two chamcicrs of a letterpair arc 
the same ("BI£BP" l)ccomcs’‘BlTXEP'. Bui it docs not insert 'X' Itctwccn pairs, thus 
*'BtEP"femains In addition, there are words which mi^i be ambiguons^eg. 

SHIS and SEXFJi. both of which arc in the diciionary. The spell checker also pnwides 
alias nodes for such eases. 

My spdl dieckcT Is btillt on the simplifying xs,sumpdon diat no double leticrj occur 
in the raw decoded text. 'Xls always expected between double letters, Tliis also 
improves the dhcicncy of trigoph checkingTo make this assumj^tion tnie.fhe 
decoder Inserts 'X' bet ween letter pairs necessary, and marks any *X' which occurs 
as the first diaiactcr in a letter pair as a ‘‘haid'^X. kxause this Is never a filler 'X', 

limits and Assumptions 


GpherTcxl and the dictionary contain only words uaine 'A' ■ Z', 

'rite dictionary b sorted. 

The pfogram u.ses the slandanl (64K) progiam stadt and allwcatcs a word stack on 
the heap tor up to 4fKJ words in the resulting plain text. 

The prt}gram uses a recursive function which takes up to bytes tm the call stack 
and reeurscs I level per word found. Ilic snindard stack siac of (M Ls only sufficient 
for plain text messaged of abi>ut 5<MJ words. 

NOTE: If it is desired to dcci>dc Ioniser texts than about 3<Kl words, 

Pkuse change the constant "^k MaxWords^ accordingly and increase 
die call stack allueailon by H IK for every ItKM) wortls. 

The array parameter - char* plainT'exi" in DccodePlayfairC) b assumcil to be of 
siiffickni sLcc to hold the resulting plain text Pl.DS an allowance for a slightly larger 
intermediate taw plain text (511% extra will cover even paihokigical ca.ses). 

Version 2 changes 


Fmc tuning for speed (15% gain), but no logical changes. Techniques: 

^ use of unsigned char instead of dvar to avoid extcndsignbli iasiractitm 
- rctjrxkring of tests in IcgalO in favour most frequenl case 
^ review of need of masking of characters. I « c, where c b an 
uppercase dmacicr This works without mask becaicsc shift is modulo 64 
V 

Jinciude **Playfair.h** 

jinciude <sLring.h> 

typedef unsigned char uchar; 
rypedef unsigned long ulong: 
lypedef unsigned short ushort: 
typedef const chat* Cptri 

static con^it char** diet; 
static int nuroDecoders; 

enuBi f 

kMaxWorda - 400 . //Increase for longer texts, also tocreast* rtack 
kMaxNodes- 27*32*52. 
kbepth - 16 

h 

etium I 

kXFLAC ^ 1. 

kJFUG - \« 27 . 

kZFLAG - 1<C2R, 

kAll * OxO/FFFFFF, 

kStarr ^ 27, 
kStartOfWord- l<<kStarl. 
kEndOfWord ^ 1. 

kJbit « (1 « (31 ^ 'JO), 


kCharSet = OxO/FFFFFE k --kJbit 


Struct Rule 

// Rule implcmeoLS the enctxling rule in a static look op rable 
static struct Rule I 
short LUTt25][32l: 

Ruled 

I 

int upotl^O; 

for (int rI-0:rl<5;rl+T) 

for (int el“0:cl<b;cl++.opotm^J 

1 

Int spot2"0: 

for CinL r2=0:r2C5;cZ++) 

for (int c2=0;c2<5:c2++>spot2+0 

i 

int vri,vr2ivci,vc2: 
if Crl=-r2) 

I 

vrl“rl; 

if (cl) vcl-^cl-l:else vcl“4: 
vr2“r2; 

if (c2) vc2'^2-l;else vc2=^i; 

I 

else if (cl="c2) 

( 

vcl“cl; 

if (rl) vrl=ri-X:c1fle vrl^4; 
vc2=c2: 

if (r2) vr2“r2*l;elijC vr2-4; 

1 

else 

I 

vrl*rl: vcl^'2; 
vr2=r2;vc2=cl: 

] 

LUT[spotU [spot2j“ 

((vrl*5+vel) « B) 

+(vr2*3+vc2): 

] 

I 

I 

1 R: 


/*“**" Trigraplto and st*i of rcbicd functions “•***•*••/ 


stntJe ulong trigraph[27][321; 


Register 

inline void Register{ulong c) 

// Single diaraeier worth 
I 

for [int l=i;K=26:i++) 

I 

trigraphti] [cl 1"^ kEndOfWord: 
trigraphlc][ij |“ kStartOfWord: 

) 


I 

inline void Registertulong cLulong c2) 

//Two character words 

trigraph[31 cIlUl k c2l |=^ kEndOfldord | kStnrtOi^Word; 


inline void Register (ill ong cl,uiong c2.ijiong cl) 

//‘YhfL-t charaacr wonls 

trigiaph[31 & cl]L3l 6 r2l 1^ kSrartOfHord | (1 c3): 

trigraph[31 k c2] [31 iSi c3] kEndOfWord; 


inline void Register (along cKidorig c2*along c3.ulong c4) 
// Fbnr duraaer words 


trlgraphfTl A cl]|ll k c2l 
trigraph [31 k c2] [31 k ell 
trigrapb[3l k cl|[31 6 c4] 


kStartOfWord I (1 << c3); 

1 « c4i 

kEndOfWurd: 


1 


^ ~ Regbtcrllcarl 

inline void RegisterHead(along cKulong c2,uiotig c3.ulong 
c4.along c5) 

trigraph[31 k cU (31 h c2l |“ kStaciOnrford | (1 « c3); 
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triRraph[31 & c2] [31 & c3] I- 1 « c4: 
trif'raph[31 & c3H31 Si c4] 1 « c5: 


Rei'i^tTlail 

inline vipid RegliJicrTaiKul^ang cl,uiong uphar* w) 

I 

ulong e3“31 (f ‘w; 
while (c3) 
t 

trigraphf3] & cl] [31 £■ c2l 1 c3: 

c 1=c2i 

I 

trigraph[31 & cl] [31 (t c2l j= kEndOrWord: 


cor»at Pha r ‘ kwd : // itscful in dchuggiuM 
#endlf 

void Init(const char' keyword) 

I 

// Sets up the unique matrix and Its invcrac (=spot) for one kejTvord 
#if KUD 

kud'^keyword: 

Ifend i f 

c omj t c ha r‘ kp"k eyword; 
uchar line[25]i 
uchar* Ip=line; 

uchar nextC=*kp: 

u 1 ong ma sk=kCha rSet; // make sure therc is no *J' 


RemovcDi >uhlcIarUc rs 

static void RemoveDouhleLettersO 
// Removes all tlonhlr kticro-scs from the triRraphs and replaces 
// tlH*m with the cseapt* seijuencrs using'X'or'2* as appropriate 
I 

for (lot cl-l:cK= 26 ;eJ++) 

I 

ulong fiet-trlgrapblcll[clj: 
if (D=set3 continue: 
lot sub; 

If fcl""(31 & ’X')} eub=31 k '2*1 else sub*31 k \ 

ttlgtfiphlell [ijubj 1 = 

(set fii kStartOfWord) | (1 cl): 
if (set k kEndOfWordl 

trigraphlsubj [clj |= kEndOfWord: 


// write unique letters in a line 
far (::) 

I 

uebar c=nextG: 
nejttC*‘*++kp; 

If Cc^O) break; 

If (e—\r> c='T': 
int blc=l « CT 

if (inaBk & bit) | 
niask ^bit; 
np++ - c; 

I 

I 

Int nuBiTtnique^lp-line; 


trigraph tell fell ^ 0: 
for (int c 2 -l;c 2 <“ 26 ;e 2 +t^) 

( 

set=trigraphtcll [c2]: 
if (set h (1 « c2)) 
t 

it (c2-“(3l k *D) sub=31 k else sub=3l k 

trlgrapbfcll fc2l“set & (“tl c2)) | (1 sub): 
I 

1 

[ 

I 


LegaJSiart 

inline bool LegalStart(ulong epair) 

I 

return (trigrapb[31 k tcpAlr»8)U31 fit epait] S 
kSturtOfWord); 

I 


IjegalEnd 

inline bool LegalHnd(ulong epair) 

I 

return (trigrapbr31 k (cpair»B)U31 fii epairj ^ kEndOtlrford): 

1 


iargal 

inline bool Legal (ulong cpl*tilcsng cp2) 

( 

return ( 

(trigraphtll 4 (cpl»8)|[31 k cplj k //ABC.? 

(kEndOfWord [ (1 « (31 4 (cp2 » 8))))) [1 
// tHTtc: mask neetkd hete becautsc cp2.hi might be kjwcrcasc^x' 

// however, It costs nothing here since »B am! &51 is one tnstr 

(trigraphfBl fii cpl] [31 4 tcp2 8)] 4 //?.BO) 

(kStartOfVord | (1 « (cp2j))) || 

(LegaiEndtcpl) 44 LegalStart (cp2)) //AB.CD 

): 


siruci Decoder 

static struct Decadnrl 
uchar Bintti*[25]: 
uchar apot[27j; 
ifif KyD 


// write remaining Icftcfs 

for (int :cC=‘Z':c++) 

t 

if ((mask 42)) *lp++“c; 
mask 1: 

1 


// transpisc line Lmo matrix 
uchar* inp=matrix: 
int k=0: 

for (Int i^:i<niii»Unlque:l++) ( 
for (ir»t 3^25: j+*nuinUnique) I 
int c=linefjl! 

•mp++ = c; 

spot [31 4 c!''k++; 

I 

1 

1 


bool SameMatrix(Decoder* dp) 
I 


// (>»mpait‘s matrices to help in dtmimiing unneetkd duplkaics 
ulong* a’^{ulong*)matrIx: 
ulong* b=(ulong*)(dp >matrix|: 


if 

If 

if 

if 

if 

if 


CalD 

Call 

{al2 

(an 

(a Ui 
(a [51 


i= b[0]) 
I- bill) 
bUJ) 
br3l) 
1= b[^n 

1“ b[5]) 


return false: 
return false: 
return false; 
return false; 
return false: 
return false; 


return true; 

1 


ulong Decode(ulong cipherPair) 

( 

// DmHlen one character pair 

// Hard 'X' is iikntiiied by kjwer osc 'x' 

int npoTC=spotr31 4 CcipherPair»8)]; 

Ini spatl'=spot[3l 4 cipherPair]: 
int spotPair=H.LPTtspotD][spotl]: 
uchar cO=matrix[spot Pair >> 8] ; 
if (cO=VX") cO^^x': //“hanl"X 

uchar cicatrix [31 4 spotPairJ : 
return (cO « 8) | cl: 

I 

int OccodeCipher(conirt char* cipherText,char* plairvText) 

i 
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return false; 


// Decodes the entire dpiicf JcjlL into i tentaUve plaintext 
// iRscTts K'or'Z' between doulrlt letters ii pair bt^undanoi 
// to aeeonujdatc spell checker tnethixJ 
const char* ct-cipherTcjtt; 
char* pr=pla1nText: 

ulortg clpberPair=* ((u&hort*)ct) ;ct’t=2{ 
ulong plaiiiPairl”DecodeCcipherPair); 

if (t3=LegaiStart [plsinPairU) 1 
return 0; 

I 


• ((trshort*}pt )«plainPalrl :pt+=2; 


for (;;ct+=4) 

1 

ulona clphscWord^’* ((ulong *) ct): 

If (tclpherWord h OxFFOOOOOO) -- 0} 
break; 


bool Jtol(const uchar cl,const uchar c2) const 

1 

return ({cl“'J') && (c2“*‘I‘)); 

I 


const char* MatcbTall(const uchar* pt.Jnt h len,lnt numX. 
Int curWord) const 

// Miches string staning at the 5th Icncr - numX 
// numX is the number of rnsened X (or Z> in the first S kitcrs 
I 

if (curWord < nuaWords) 

f 

const char* wp”wordfciirWord!; 
const char' teap^^p-t-S-numX; 
len=5; 
uchar cl; 

while {0 1= Ccl “ *tenip)) [ 
uchar c2”ptLlonJ ; 


ulong pIaitiPaltO=J>eeod€(eipherWord » 16): 
if (0*^(0xLF & ((plainPairO » 0) ^ plainPalrl))) 

I 

if ('X'“(fix5F 6 plalnPairl)) *ptH = “I*; 
else *pt-H - ; 

J else if (ILegal(plainPalrl.plainPairO)) 
return fi; 

* ((usho r L *) pt) “plainPai rO; pt-P“2: 
i£ ((cipherWord & OxOOOOFFOO) = 0) 
break: 

p lai nPa i r l^^Decod e (c 1 ph e rWo rd 3; 

if (0—(OxiF 4 ((plafnPafrl » 8) '' plalnpairO))] 

1 

if ('K'^(GxSF 6 plaltiPairO)) ‘pfH* *Z': 
else *pfH- “ 'X*: 

I else if (ILegaKplainPairO/plainPairl)} 
return 0: 

*( Cushort •)pt:)-plainFairl jpr-H'?,: 

1 

pl[0]-0! 

return pt plainText: 


i 'D: 

//The spell checker tax Ls a three Icvd hienirehy: 

// Nijck -> list -> Stem > dk-tionarj Word 

// Modes are in a 5<)imcnsioftal table accessed by the first 5 characters 
//A node contains poinicra to up to 26 lists. 

//A list contains up to 26 stems , 

// A stem cxiniains a pointer to a djctiunart' wird, 

// lod Uic nunitXT of words in the jjnjup with the same stem. 


if (31 & (cl ' c2)) 

t 

if (TnsertRdX(c2,pi,len)) 

1 

temp-: // skipped X, itpcat comparison 

I else if tUtoncl.c2)3 
break; 

1 

len++; 

teaip+4: 

J 

If (0^'temp) 

return wp: 

I 

return 0; 


smict LtnkcdNodc 

// Lists and Motk.'s are dynamically allocated 

//They arc descended bom LinkedNode and maintamed in a linked list. 

//This is to allow them io i>e deleted wlicti lrnnHaylaiK) is called 
struct LinkedNode I 
LlrtkodNode* link: 

LinkedNode(LinkodNode* Ik):link(]k)11 

h 


struct List:LinkedNode I 
Stem group L27j; 

List* alias: 
ulong xjFlag: 


List(LinkedNode* Ik.ulong flag)J 

liInkedNodedk] *allas!0]i .xjFlngtflag) 
Imeinset (group. 0,sizeof(group}}; ] 


struct list 


// Shtjfter words are referenced by using the nnndcx at each level. 


void Add(ulong c*ulong w)lgroup[cJ.Add(w):] 


struct Stem 

struct Etetn i 

const char ‘ * word: // a dictionary' word 

int nuinWords: // number of wondji with common stem 

void Add(ulong w) 

if (wor4-*0) t 
word^lct-tw: 
nuaiWords“l: 

J 

else nuntWords-H': 

I 

bool TnGeriedXfconsl uchar c,const uchar* pt.int len) const 

uchar c0=pt[ien‘lj: 
if ( (cO=pt [ien+i j) && 

( (c--*X;) II {(c“'X‘3 U CcO—-xO) ) J 

I 

return true: 

I 


const char* GetListLeader() const 
t 

ulong n=grotip[0] .numWords; 

If (n) 

return group[O]*word(Oj; 
return (const char *} n: //== 0; cast saves 2 instructions! 

) 

I; 


strurt Ndde 

struct Node:LinkedNode I 
List* Hsl[27): 

Node* alias; 
ulong xjFiag: 

Node(LinkedNode* Ik,ulong flag): 

LinkedNode(Ik),alias(0),xjFlag(flag3 
Imemset(list,0,slzeof(1Ist)J;J 

void Addfulong c,Llsi* IpJ lllst fclnp; 1 
const char* GetNodeLeaderO const 
( 

List* Ip^listtOj; 
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if (Ip) 

I 

If (lp->gr(>upl0) »nuaWords) I 
return Ip >grtjupi0l .word{0] : 

1 

I 

return (confit char") 1 p: // = 0; ost saves 6 instniciiniis!! 

I 

h 


stmci CodcBicakcr 

fitatic etruct CodeBreaker I 
LlnkedMode* nqdellst; 

Node* baseIkKaxNodesJ: 

Cptr wordStacklkMaxWords]: 

Cptr* stackPtr? 

int cache; 

CodeBreaker(const char *worde[]dong mimDictionaryWotds) 

:nodeLlat{0^ *cache(€).stackPtrCwordStack) 

[ 

// The cofLstrucior crcaics ibc index utc from the diakynary words 
dict»worde: 

SetupDecodera{numDictionaryWord s); 

meELsat(bane^O«sixeof(base)) ^ 

for (ulong w^;w < nuaDictlonaryWocdsivH*) 

I 

const char* word^dict[w|: 
ulong first^'C(const ulong*)¥ord): 
ulong c0*31 & (first » 24)* 
cl-31 & (first » 16). 

C2-B1 & (first » g)* 

C3-31 6 first, 

c4=31 & word[41; 

// Change all 'j' 'i' as we analyse the letters 

uiong nodeJflag-0: 
if (c0“(31 & ’J')) 

1 

c0-(11 h ^T’}: 
nodcJflsg=kJFUG: 

if (cl-=4}3 
[ 

List * 1 p“NevLlst (0,0, v); // only a I letter word 

Nod c * n p=NewNcid e (0): 
baRef32*12*cO]*npT 
np >Add{0,lp); 

ReglBter(eO): 
continue: 

I 

//At least 2 letters: 

ulong nodeXflag"0: 
if (cl—£11 h *J')) 

I 

cl-£31 b '1*3; 
nodeJfUg 1“ kJFMC«l: 

1 

if CcO — cl) 

I 

c4“e3:c3*’c?.:c2^cl; 
if (eO — (31 b *X*)) f 
el • 31 6 

nodeXflag |= kZFLAG; 

I else cl “ 31 6 T i 
nodeXflag |- kXFLAG; 

I 

if (c2—0) 

I 

List * lp=NewList to. 0,w): // only a 2 kiter word 
Node* np"NewNode(0): 
base 132*02* cO+c 1) +c 2] -np: 
np">AddtO,lp): 

RegiEtar(cO.cl); 

continue; 

1 

//At least 5 letters: 

if (c2—(31 b 'J*33 


( 

c2-(31 b *1'}: 
nodeJflag |- kJFIJ^G«2: 

if {cl = c2) 

( 

c4=c3:c3=c2: 
if {cl — (31 & *X')) { 
c3 = 31 & ‘Z‘: 
nodeXflag |- kZFUG; 

1 else e2 = 31 b *X'; 
nodeXflag |= kXFLAG: 

I 


Node * iip=base [32 * {3 2 * eO+c 13 +c2l; 
if (np*=£>) 

base[32*(32*c0fcO+c2]» 
np=KeiiiNQde(nodeXflag ] nodeJflag): 
else np-GetAlias{np»nodeXflag | nodeJflag); 

if tc3^0) 

I 

List* lp=Ne¥List (0); 

np->Add (0 * ip): // only a 34ctter woiid 

Ip->AddfG,v): 

RegisterCcO,cl*c2): 

I else 

// more than 3 letters 

I 

ulong iifiCXflag-0,llatJflflg-C: 
ulong nuisX-l & nodeXflag; 
if (c3“(31 b 'J')) 

I 

c3»C31 b ‘1*3; 
listJflag “ kJFUG; 

1 

if (c2 -- c3) 

f 

e4—e3; 

if (e2 = (33 b ‘X'}) I 
c3 31 & 'Z': 
listXflag 1= kZFLAG: 

1 else e3 = 31 b 'X‘; 

listXflag 1“ kAl 1: // all ijtems in list affected 

nuniX++; 

1 

List* lp=np >list[c33; 
if (lp=G) 

i 

lpF=NewList{ listXflag): 
np->Add(c3,lp); 

) 

if (c4=C31 b ‘J’)) 

c4-{3l i ‘ I *); //no need for fSagJ foUows I 
if {c3 = c4) 

I 

if (c3 = (31 4 ‘X'3) ( 
c4 = 31 & 'Z'; 
listXflag 1= kZFLAG; 

I else ck “ 31 b ‘X*: 

listXflag |- I « c4; //only Ml stem affected 
nuiEX++: 

I 

lp=GetAlia3{lp,listXflag | listJflag); 
lp->Add(c4.¥): 

// Rc^ster all trhpaphs fittm this word and stem 

if (c4—0) KegisterCcOiCl ♦c2,e3); 
else 
( 

RegisterHead(eO,c1,c2,e3.c4): 

RegisterTall Cc3 .c4. (uchflr*) word+5 ’nuinX) ; 

1 


) // end of loop through the ctiaionary 
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II Fixup trigraphs 

RemoQUb leLe t te r S 0 I 

I 

“CodeflreakcrO 

I 

// Destructor releases all dynamically allocated nodes and lists 
LinkedNode* np“nodeLisc: 
while(np) 

I 

LlnkedNode* next'^np->linkt 
delete np; 
np=iiGxt: 

I 

delete [I Tt: 

I 

void $etupBeco<iers(long numUict ionary Word a) 

I 

II Scans the dictionary and allocates 1 decoder per potential keyword 
D^new Decoder[numDletionaryWordsJ; 

Decoder* dp“D: 
coast char” wp-dici: 

fox (Int i^:i<numDictlo[isryWords:i++tWp-HH) 

I 

dp->Init<*wp): 

Decoder* dx’^dp-l: 
ini k=kDepth; 

// Scans backwards to discover perhaps ktcnUcal matrizes. and assigns 
// this matrix only if it is unique. 

// (Example GUESS :md GUE&ES yield the same matrix, QO need to keep both) 

for C:dx>"D:dx".k-)I 
If (k<«0) break: 

If {dp->SameMatrix(dxJ) 
goto coat: 

I 

dp-H-; 
cant: i 
I 

n miiDecod e rs^ p ■ D: 

I 

//Allocation of lists and nodes, and linkage in duUn for memory mgmnt 
Node' NewNodeCulong xFlag)f 

Node* np^iow Node(nodeList.xFlag): 
nodeList=np: 
return np; 

] 

NewList(ulong fiag){ 
iist* lp=nev List(nodeList,flag); 
nodoList“lp: 
return Ip: 

J 

List* NewListtlni Index,ulong flagpint v)I 
Lis t * 1p^NewLis t(flag): 

Ip->Add(index: 
return Ip: 


// AUas nodes and lists are chained o0 the Drsi node or list 
// with the same > or ■I'lctier key 

Node* GetAllastNodo* np,const ulong flag) 

i 

if {np->xjPlag = flag) return np; 
if (np->alias“*D) 

I 

np->allas=NewNode(flag); 
return np*>alias: 

\ else return GetAlias(np->alias*fiag)i 
I 

List* GetAlias(LisL* lp*const ulong flag) 

[ 

if flp'>xjFlag = flag) return Ip: 
if flp->alias—0) 

( 

Ip >allas"NewLiat{flag): 
return Ip >allas: 

I else return CetAHasdpOalias^flag}: 


bool Spell(const uchar* pt,int tailLen,const uchar 


lastChar.lnt nmnWords]; 

II Recuniive* nol hjUned, defined below. 

void Push {const Gptr vp) t'stackPtrH- wp:J 

void CopyStacklchar* text) 

// Copies the word stack of soliitum words back into plaintext 
//This overwrites the tJccoded plaintext with dictionary words 
// and autonuitlcally takes care of l/J equivalents ajid %/l fillers. 

[ 

while (stack?!r > wordStack) I 
eptr wp“^‘-stackPtr: 
uchar c®^*wp: 
while (c) I 
*texL++=c: 
c“*++vp; 

1 

1 

*tGxt“0: 

) 

void Cache(Decoder* lastUsed) 

I 

II Builds a cache of rtccntly used decoders by moving bstOsed forwani 
Decode r * nextCache“D+cache: 
if (nextCache < IasiUsed) 

1 

Decoder teiiip“* next Cache: 

'nextCachG"“lastD6ed: 

*l3stDsed=tamp; 

ceche++; 

I 

1 

I ’C: 


II (CKlrBrcakcr^pell 

// Returns true if the string in pl[] of length tailLen can be parsed 
// into dictionary wonds^ aikrwing fbrj/l suhsiltutions and X/Z fillers. 

// On eacli recursion it attempts to match the head of j>t|| with a 
// dictionary word, and if succcsshil, stacks a pointer to die word 
// and calk itself with the shortened string until the end of ptl] is 
// reached. 

II Note: tailljcn and wordlengths refer lo decoded plain text and 
// words beftitt filler 'X' and T characters arc removed, 
bool CodeBreuker:: 

Spell(const uchar* pt*lnt railLen, 

const uchar lastChar,int numWords) 

I 

If C^nuraWords <*0) // rimtlmc check agaimit stack twerflow 

( 

nuiaWords++: 
return false; 

I 

const char* wp: 

// Get Node matching the finit J duiracters 
ulong pt0123=*((ulong*)pt); 

Node* np=baser32*(32* 

(31 & (pt0l23 » Ih)) i- 

(31 (ptOlZl » Ifi))) + 

(31 & (pt0123 » 8J)]: 

If (np) 

ulong hardX“pt0l23 4 0x20202000; 

if {hardX U 

(1 h np >xjFlng) ith 
(0=(kZFLAG 4 np >xjFlag)) 

) np=np->flllas: 

while (up) ( 

II Get list matching the first 4 cliaracicrs 

List* lp=np->listl31 4 pt0l23j; 
hardX-Dx20 4 (31 4 ptOlZl | plt4j): 

if (hardX 44 Ip 

44 (1 4 Ip >xjFlag) 

44 (0={k2FUG 4 lp->xJFlag)) 

) lp=lp->alias; 
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I 


while (Ip) { 

// Get sicin maiching the 5 chmeters 

Stem' gp-Wp->groyp[31 & pt[4]]i 

if (gp->nuipWords) 1 

// lixplofr jiU wiifds matching the first 5 characters starting with 
// the last wMxJ in the group (hopit^ to catch Jottger words firsi) 

Int curWord=gp->niiittWords; 

Int nmS = // make this a function 

(1 i np->xjFlag) + 

(1 & (lp*>xjFla6 » pi[4j))t 

tio i 

int I Of]; 

wp*gp >MQtchTail(pt.len.nuiiiK,-ci:rWord) i 

1 r (wp) 

I 

if (Clen=^talILen) 

I I (SpelL{pt+len*tailLen-len,pt[len* 

1], uutuWords))} 

t 

Push(wp); 
nuniWords-H'; 
return true^ 

1 

\ 

I while (curWord > 0): 

I 

//Iry the 44encT word 

wp“l p- >Got Lis Header (} : 


if {C4^tallLen) 

I (SpelI(ptH,tailLeii-4,ptt3] ♦numWords))) 

Push(wp) I 
nuniWaTds'H‘; 
return true: 

\ 

1 

ip'‘ip->alias: 

1 

// No luck so fiu, try the 3-letter woitt 

wp*np >GetNpdeLeader(); 
if (wp) 
f 

it ((3^-nallLen) 

II (Spellfpt+3,tailLeu 3,pt[2]^numWords)))1 
PushCwp); 
ntiffiWDrdst+: 
return true: 

I 

1 

np=^ip >aliaB: 

) // end of tests wivcfc first 5 letiersi match 

1 

// in' ilie 2-Cetterwurtl 

np'bafie[3r(32M31 & ptl0j) + C31 & pt[ll))+0]i 
if (np) 

wp^up >GetNodeLeader C): 
if £wp) 

( 

if C{2--tailLeti) 

11 (Spell (pt+Z, laiLLen-2,pt[lJ ,nmiiWotdH))) i 
Pu8h(wp); 
numWordu++: 
return true; 

I 

\ 


//’Ity Ok: t-letter word 

’ np"baBet3Z*(32“C3i & ptfOl)-K))+0); 

if (np) 

( 

wp^ip ‘ >G€tNodeLead6r (); 
if fwp) 


if C(l“taillen) 

II (Spell (pt^l. lallLen l tprtO] pfiumWords))) | 
Puuh(wp); 
nuntWoids'H-; 
returi]. true; 

\ 

I 

I 

// I'inallj try tf this is a tiller 'X' of Z' berween words 

if ((pt[o]—X') I I 

((Q={31 & (lastChar " 'X'))) && [pt(0] —Z*)]) 

If ttaiiXen=“l)I 
iiuiiiWords++: 
return true; 

} 

if (0=(3] 4 (lastChar ^ pttlj)) 

44 Spel1(pt+l,tailLen'1,0.numWords)} 

I 

// nothmg to slack, just cany tm unwituling 

numWords-H-; 

return true; 

1 

] 

// Spdkheck failed: no word matches at Uib odset In plaintert 
nunWords'H-; 
return false; 

1 


InitPlayfeir 

void InitPlayfair( 

const char ‘words [], /* dictionary words V 

long numDlctiotiaryVlorda r numherof null-terminatctl words in 
dictii>naA' 7 
) 

I 

C * new CodeBreakerCwordstiiuraDictioRaryWocdfl): //alfthafs 

needed 

[ 


DecodePluylair 

void rk?codePlayfair{ 

cotiEt char 'cipherText, /* niilNermiiiated text lu decode V 
char 'plainText /* niiP lermhiaied decoded text V 

i 

// DcctKics ciphcfText into plain lexi, 

// If no s<y1utk>n is fixmd, plain I'exi will Ixr a gibberish string 
// of the same length aus dpher lcxt. or po?«ili|)^ a bit longer 

if ((C?='cipherText) || (Rtrleri(cipherText) 4 1>) 

// CaniioL handle empK or ixlddength cipher text sirings 
return; 

Decoder* dp=D; 

Decoder* dEnd=P+numl3ec ode rs; 
for £; dpCdEnd; dp-l-+) 

int Ien=dp>DecodeCipher£cipherText.plali)Text); 

if £len 44 C->Spell {(iichotMplainText .ien.O.kMaxWnrdfi}) 

C->CopyStack(plainText): 

C >Cache(dp}; 
break; 

I 

1 

I 


TeraiPlayfiLr 

void Tempi ay fair (void) 

1 

delete C: 

I 

m 
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Got a bright idea? 


Got a guide? 


Got capital? 



Stcurb up. Kick butt. Cash out. 


It's a jungle out there. 

Time was when two guys in a garage could start 
a company that would change the world. 

That time has gone. 

To build a great company today, you’ve got to 
have your act together. Completely together. 

Got what it takes? 

Join Guy Kawasaki and friends for a 2-day brain dump. 

Bootcamp for Startups 

A conference for entrepreneurs 
Feb. 28/29 
Seattle, WA 

Register online at http://www.garage.com/bootcamp 


Garage.com helps entrepreneurs build great 
high tech companies. We offer an established 
network of industry experts and insiders, people 
who can help you predict, avoid, and manage the 
many obstacles facing every startup-from writing 
a business plan, to protecting your intellectual 
property, perfecting a pitch, creating a buzz. 

You get the idea. 

Join us for a two-day conference, Bootcamp 
for Startups” where the high tech community's 
best and brightest will share their experience 
and insights. No frills. No hype. Just straight talk 
from folks who have been Uiere, done that, and 
know what it takes to survive the startup jungle. 

garaget!tcom“ 

vtc start up startups 


Cqtvtfiiht O l!K« fliiBflB.cdm. Wl Tlghta reslirrttl. 8iirjiM,Cdrfl. liie asraw-eem loflo, Boaiciunp jot Sunups ore urnfleiMrto at ijaraiiB.cm, 










WEB SITE 
DESIGN 


by Avi Rappoport 


Remote Search Services for Web Sites 


Adding search to your site 
— even if you don’t own the 
sender 


'lliis i^view covers die iimge of leiiitjte sairch .services, tlieir 
feaaires and tJieir dmwlxicks. It will teach you lo prepare your site, 
iry indexing ii, lest ihe search, ctisiomize the results, keep die search 
up to diite, and chcxxse the right program for your long-term necxis. 


Wnvr IS RtMoiii Snii Searuung? 

When you want to add search to your 
site, you may lx? have some tecfinical 
(.lifTiCLillics. Pertuips your site Ls liosLed c^n a 
large server somewhere, or you lizive an 
unctxiperative weh administrator, or the 
challenges t>f adding a CGI are Ux) daunting. 
Never feari You can ouisoutce your .seaich to 
a nmote Hite mircb senfice 3n6 Id someone 
else worry alxiul the gory details. 

Tlic indexer and search engine run on 
the remote serv^er: they will use a w'eb 
indexing robot, or spider, to follow^ links on 
your site and read the [lages, liien store 
evejy word in the index file on that seiYer. 
When it comeif time to search, the Fortn on 
ycjur local Web page .semd a message to the 
remote search engine, Althougli it’s going 
ihmugh tile Web, prfxress doesn’t change 
— it just lias to move a little fanlier. The 
remote searcli engine takes the search 
terms, matches the wmrds in the index, 
sorts them according Lo relevance, and 
creates an irrML piige with tlie results. 
When a searcher clicks on the result link, 
tliey will see the page Irom your site, just 
as though the seareli emrie from tJiere, It’s 
easy and painless for practic’iilly everyone. 


What you Get With Remote Search Services 

• IVo need for server acce^: Even if your site is hosted and you 
have acc'ess only, you can am a search engine. 

• No need to learn CGIs or server systems; You never need to 
install any si)ftw'are. worry about versit>n c'ompatihiiity, or learn 
4il3out perniis.sit)ns and jxiths (or paying someone else lo do so). 

•Easy administration: The remote search service will provide a set 
of Web pages for adininistration, iTither than milking you learn 
aix>ui coiiiiiiarid lines or config files. 

• No Uxid on your server: Search engines require sigiiihaint 
resources, such :is CPL! time during researching and retrieval, as 
well as disk space. Ouisourting to a remote .server moves the 
loud away tksm you. In addition, tliese sciycts are usually in data 
centeis with excellent connectivity and 24/7 administration. 

• Minimal Lnllial uivcsUncnt: Insteatl of paying for a search 
engine up fix)nt, you can pay a small montlily fee. Some services 
are free, showing advertising witli ilie ,seaR4i results. 

• Easy lo switch: If you aren’t happy wiili your search sen^ice, it's 
ea.sy tt> switch to ant >1 her. 

Tlic Tradeoffs 

• Advertisiiig or cootiiuimg costs: You must [lay cYcry^ montli or 
iUlow yt.}ur searchers to see other jieople's advertising 

• Less control over the Indexing: I f your data changes frequently 
(iioLirly t)r daily ), iiKxst of llie.se services will noi index tlmt t>flen. 

• Dependent on outside service: If die seivice's .search engine 
gtjts busy, it jiiay clelay responses for yotir site, and there’s not 
much you can do. 


Avi Rappoport is tlie Princi[ial Qin.sullimL for Search Tools Con.sLilting, specializing in Web Site, Intranet and Portal search 
engines. She reports and analyzes the industry for SeafchTools.com (which runs on a PowerMac 6100). You can contact her 
at consult^searchtools.coiTi. 

Disciaimer Search Toois Cortsuilin}^ has comulling reiationsbips uith MondoSearch and SearebButton. hui tw do not allow our 
cusiomejs lo injhumce our remews. 
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• Less capacity: The remote search services have a page 
limit, usually somewhere l>etween 200 and 5000 pages. 
While many can go higher than that, they can't handle 
hundreds of thousjmcLs of pages. 

• Fewer special features: Each search engine has iLs own sjx^cial 
features, hut you have nKjm choices if you plan to lun your own 
engine. Fur ex;iniple, imiexing password-pix>TecTetl areas, or 
word pnxessing file fonnats, adding a thesaurus or a 
spellchether, etc. 

• tnlninet privacy: Intninets (internal netwt>rks using standard 
softwitre) want to keep contn>l of all their data, rather than 
allowing acces.s external systems. 

• Multi-site indexing; Mast teniolt? services allow you to index 
just tlie sites you xt)ntroL With a Itxtil seamh engine, you can 
index other site's and create a public semii portal. 

Rfmotf Sitf SFARCJi Si-KvicTiS Covi^Kn 
'llie following services are covered in tliis neview^ and also liave 

pages and examines on tliLs site. 

Atomz <http://www.atomz.corn/> 

• free for 500 pages, fewer tliiin 5,(XX) .searches [m mondi, {no 
ads, just a k)go) 

• jxiid version: 250 pages 8l 2.5K searches @ $75 per yc^ar; 500 
pjages 5K seaichcs/month @ S150 per ye^ir, 1,(XX) pages ik lOK 
.sc’arclics/Eiionth @ $300 per yeetr; 2,5(X) pages 25 K 
seuiches/month ® $600 [xjr year; 5,000 pages & 50K 
scjiiches/munili @ $l,2tX) per year 

FreeFind <http://www.treefind.aMri/> 

• free (with advertising) ran Itandle up to 32MG of Ifl'Mi 
(flexible), will “sttmple" sites if they get large. 

iiitraScarch (WhatlJSeek) <http://www.whatLlseek.corri/intraSearch/> 

• free (wiili advertising) to ar least 10,000 i>ages 

MoiKioSearch (rx^motc version) <http:/A/wwv.i7>oridosearch.com/> 

• paid versitm only: 1 - 1,000 pages: $144; to 5,000 purges: S585; tf^ 
lO.fXX) pages: $990; above: contact sales@mondosoft.coni 

• load server version also available 

PicoSearch <http://www.picosearch.coTn/> 

• free (with adventsing), to 5,000 pttges 

• paid versam: $6.99 per month (12 aanmitnient); $9.99 

|x:r monili (3 month commilrtK-ni) 

Pinpoint <http://pinpoint.netaeations.com/> 

• fire (with advertising) to 5,000 pages 

SearchRutton <http://www.searchbutton.com/> 

• free (widi advertising), for up to 5,000 pages, 30,000 
searches per rnunrh 

• ptiid version: up to i,(XX) pages: $300 per year, u[) to 5,000 
pages: $600 per' yeiir (limit of 30,fX)0 scinches per month); ftsr 
niDie pages, ct>ntatt ampany 


SiteJVliner <http://www.siteminef.corrt/> 

• free (vvidi advertising), to 10,000 + |>ages 

Webinator (remote version) 

<http://vwwv.thuriderstone.c(>mAexis/inde^^^^ 

• five (witli Ihunderstone logo), to 5,000 pages 

• local servvr version also available, ran do tliousands and 
millions of pages 

ChecxJxNG Links .4M> PaCpES 

Before you install any search engine witli a indexing spider, 
you must make sure it cm find die pages on your site. The good 
news is that cleaning up your links will improve your 
acces.sihility to die large public search engines (such as 
AltaVisui, Gtxigle, HotBot and Inhiseek), and make it easier for 
you to mn an automated site mapj^er. 

Robot Spider Compatihility 

Tine irKlexing spitk^rs follow links fitim a sKiiting page, so use 
a home p;tge if you liave gtxxl text links, or a site map page. 

Wliole sites: Robote,txt 

The fir.st thing is to check the ‘Tobotsaxi” file. This is a 
stanckird file for web servers that sits at the rxx>t of your site, and 
excludes rolx>ts that are not welcome on the site, or in certain 
specific directories (iliough this is voluntary). If you run your 
own server, you control this file: odierwLse your host server 
administrator controls it. 

Yoli want to miike sun: tJiat this file exLst-s, and iliut it allows at 
least ycHir indexing spider to access your direclories. You may need 
to negotiate with your web htisiing provider on tliis point, as this file 
must lie sttired in the rcxji folder of the w'eb h(\sr. 

For more infonnation on this topic, see Search Indexing Robots 
and Rolxits.txt: <http://www.searchtools.eom/info/robots/robots-txt.html> 
and [lie WehMasters Ctuide to tlie Rolxxs Exclusion Prottxol at < 
http:/Ainfo.wGbaawter.corri/maldprojeds/robots/exdusion-admin*htrn^ 

IndMdiial Pages: META ROBOTS tag 

‘Hie other way dial page designers t:an control rotors and 
spiders is by using the META ROBOTS tags. ITiese are 
particularly useful if you have a hosted site and don't want to 
bother your server administrator. 

For example, if you have a direc'Lor>' listing or site niiip page, 
you can tell the spiders to follow ilie links but not index die text on 
tlie jxige by placing die following information into die IFTML header: 
<rneta rmme="robots”coritent="noindex,fdlow^ If you have pages with 
useful data but inappiTvpriate links, such as a web oalendar page 
with duplicate links to odicr calendar pages, use <jnneta name=Yobots'' 
content=1ndex,rKllbllC)W'>, 

For more infbrm^ition, see Search Indexing Robots and die 
Robots Meta Tags <http://www,searchtools.com/info/r0bots/robots- 
meta,html> and tlic Webniiisier guide alTovct 

GcxkI Links and Rad links 

Indexing spiders lend to to pretty dumb. Tliey know about the 
simple HJiEF links, but just get lo^st on anything more c:omplcx. 
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Spiders and robots may na fuller links in: 


• image mafis (esptx:ially server-side image maps) 

• rediiea and META Refa^sh 

• Framesets 

• DIITML layers 

• ActiveX conrok 

• JavaScript menus and pages 

• Java Images and site maps 

• Flash or Shockwave (unless you use the Artedihcx:k options to 
generate H'l'ML text and links!) 

Check Your links 

To give yourself a spider-eye view, try a text brtjwser 
such as Lynx, or a graphical browser with images and 
JavaScript turned off, and no Plug-lns: this will give you a 
good view of what the spiders see, 

Don) rely on your content-management system to check lix:a! 
links: it knows too much about the structure of ytxir site and llie 
special formats you use! 

To make sure all your local links work, run a link¬ 
checking robot such as Big Brother For Mac ik Unix 
<http://pauillac.inria.fr/%7Efpottier/bb.html-en>, or use a service 
such as NetMechanic <lmp://www.netmechanicxom/>. If 
these services can follow the links, there's a good chance 
that your search indexing robot can dt> the same. 

Solution: Supplement Complex Links 

If you find you have problems, there are two ways around 
bad links: Ix)th require work, but they will make the indexing 
spiders happy. 

• Alternate N 3 vigatit>n: acid alternate links in <NOSCRlFr> and 
<NOPKAMES> tags, lists of Lite links fmm image nups. simple 
alternate pages for DHTML and Java piiges. etc. 'nils should 
work for all kinds of robots and spiders. 

• Site Page listit^ make a page or sitemaji with links to every 
page on your site. IhLs Ls liitrd to maintain and synciironkc wiiJi 
your other clianges. You on) use a site maptx.T appliotion that 
uses a link-following rolxX, because it will have die same 
j^roblems that the search engine spiders have. 

Five for the Price of One 

Tlic gfKxl news is tfuit all tliis work w'ill pay off in five ways: 

T Your search engine ioIkh spider can hnd your jxiges 
2. Tlie n)bot spiders for tlie webwide public seaa'h enginc-s such 
as HotBot, Infoseek, AltaVista find your pages 
3^ Robot-based link checker t^in check your links 

4. Rolxn-based site map enrator tun find your pages to make a map 

5. Your site is now accessible to blind and visuaJlynJisabled web 
surfers (as dL*scTilxxl in the W3C Web Accessibility Initiative), and 
ditxse using text browsers .stidi as PDAs. 


Search Services and Complex links 
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Tfst thi- Indi^ 

Many of tJie search ser\dces require minimal commitment 
on your pan. All you have to do is go to the service Web site, 
register with a user ID or email address and password, then 
give them the home page URL, 'I he search service will send 
their indexing spider to follow links on your site very quickly, 
so try to do this during a quiet lime, 

Once you have signed up, youll see all the setup and 
tonfigurarlon options in die hnowst^r interface. Stinie are tnore 
dalKrate than (Xhers: Atomz lias a bunch of lal:>s ;ind subfxines 
within die tal>s, Frec‘Fin<i has a nice Wiziird interface, Webinator has 
a fairly eLtlx>rate nxtil-lxick access comnd: you must liave an einaH 
addre-ss on the server to index tJiat .serv^er. 

If your server is slow, you are diaiged by ilie byte, or you have 
lung files, choose a service diat will do smaiT updating, and only get 
die a>nienfs oJ' [Xiges if diey liavc dianged. 

If yuLi luive 'Access to your web site lug or monitor window, you 
can ivatch die spider as ii follows links diruughoiiE your site. 
Otherwise, or in addition, chtxxse a .service dial provides jx^ixxts on 
die indexing pitHTSs. 
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Scarciiing 

'lliere are two basic kinds of searcli queries: those wiut:h 
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imich any search fenii. tJiough they may not sshow you every 
matching page . A few will let seiirchers chtxxse the l>est approach. 
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Introducing. 


Funnel 

Web 


Funnel Web's innovative design and 
powerful feature set helps make sense 
of complex Web sites by identifying 
key trends and events 

Features 

• point and click interface 

• over 50 reports and graphs 

• up to 50 times faster than 
major competitors 

• platform independent 

• works with any web server 
on the planet 

Advanced Technology 

• Event Messaging 

• Remote Administration 

• Realtime Monitoring 


Intelligent Web Monitoring and Analysis 


Accuracy, speed, ease of use and powerful report-formatting 
capabilities, makes Funnel Web the perfect solution for 
monitoring e-commerce. Intranet and Internet sites. 

Backed by Active Concepts unrivalled 24 hour technical support. 


Download a free demo version at 
http :y/ww w. activeconcepts.com 
or visit our website to find out more 
about the killer Funnel Web Spider... 
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SiteMiner result for the same search, shomng 
all three pages with all search terms 

If your site a)ntiiin,s text fnjm other languages, you need to 
watch out for letter tiiatchiog issues. Some search engines can only 
match the 26 English characters, wliile others can matdi diacriiioil 
characters (such as ? and a) and special chantaers (0 and \i\ 
PicoSearclt and MondoSeardi alsc:> ofier multilingual interfaces. Non- 
Uoman scripts such as Arabic^ Russian and Japanese are even liarder, 
although PiccxSearch offers results in Chinese. 

Relevance Ranking 

When you ck) a search, and the engine locales a set of ptiges 
that nuitdi your search, it has to sort them as best it can, ITiis Ls 
particularly difficult wiili one and two word scanhes—it's hard to 
tell which is die most releimtt page (the Ix^ match). 

Like hairstyles and masic, success in relevance nmking is a 
matter of Laste, You sltould do a numlx:r of soinJics to see what you 
tliink of any search engine you choose. Try searches witli just one 
woixJ, others with two. and still olhei's with four or five, 'Ihls ,sliould 
give you a feeling for tlie kinds of relevance ninking that a search 
engine will do. 


Search features 
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Sfarch Forms 

Search fontis are die user interfaces to the search engine, so 
yoti can liave sevml different fomis, for your varitxrs needs, 

• Search Field: Otis is very .small form with a text field and Search 
button: it can go on your front page or even in die navigation 
Irar on ever>^ page. 


• Simple Search: a search form wiili an addiiional option or 
twoj which may be on a search page with instructions and 
tips- Note that SiteMiner has a JavaScript search fonn, rather 
than a normal HTML form, 

MondoSearch 

Enter your search vords: __ 

[ # Sear^ 

Search for all the vords 
Search for any of the vords 

Mon^ic}Search Simple Search form 

• Advanced Setreh: lets die searcher have more control over die 
search, with options for dare ranges or special zones. Only 
SearcliButton, MondtxSearch anti Wehinaior include advanced 
search forms, though they have sli^idy quirky options. 

Eadi of die site stanch services provides an HTML or JavaScript 
search form for you to copy and paste to a page on your site. All 
you have to do Ls put the form into a piige (you don't even have to 
pcxsL die page on yciiir site at fust)- When you. or a searcher, types 
text into the field and clicks on die Search Imtion, die brciw,ser 
retxignizes the ACnON attribute of the FORM tag connects to die 
.search server, and .sends the form items, including the hidden site 
ID. so die server cun tell which site you mean to search. 

When the remote search server gets the fiinn t:ommund, it 
l<K)ks in the index, matches the search words, and organizes the 
results. The URL of die results page is that of the search service, 
not of your server, because diat's where the re.sidis page is 
coming from, but the URLs for the found pages diemselves 
include your server name. 

Note: SiieMinei‘ only lias u JaraScripi se^ardi Ixix: site visitors 
without JavaScript must follow a link to tlieir site for seaidiing. Tliis 
liiniLs your uudient:e and makes it bird for people with old 
bnmsers, PDAs :ind tidier new diem liurdware. and those with 
impaired vision using speaking browsers 

CUiflDMlZING RESULT'S PACiF.S 

Everyone Ls familiar with webwide public search engines and 
their lists of results. A local search results page is very similai; 
aldiough for die lx!,si user cxpcrient:e, the ,seurdi results fxige should 
look and feel like the rest of your site. If you are using a remote 
search service as a permanent part of your site, l?e sure diat you 
chtxisc u service that lets you ciLslomize die page design enough for 
your comfon level. 

Simple Customization features 

• page color: let you select dtc ptige cxilor. sti it imtcrhes the rest 
of your site design 

• background: set the bickground graphic 

• text and link colors: keep die texL link, active link and visited link 

colors consistent with the rest of your site 
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Page l>esigii 

Some services lei you lay oui your resulLs page, including tile 
page .scciions alxjve, to die left, to die right, and below the results 
list. Tliis allows you to include your normal navigation and site 
stmeture links, showing sean::hers more about the scope of your site. 
This usually includes fields for you to paste in your HTML code, and 
you will pn^l-iably have to try this a couple of times to get the right 
relation ship with the results list, so tills is only acc^sible to ifiose 
who have some ITTML Lag experience. 


HTfiL Hsader: 


<HTWL> 
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tokvlai*— 


Luiri^^^-*'.C^;y* ,"7g" hnrnin 


MU 


Webinatorjwid to insert page header in HTML 


Advertising 

Several of die free site search services will display lyanner 
acK^ertising on the search results, although none of the paid vasions 
will do so. for many sites, it’s a fair tmde for searching services, hut 
for odiers, sucli as libraries and public schools, advertising ts 
inappiopriate, so diey should choose a version widiout advatising. 


Results Page Features 
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Sfarch REstcT UsT !tfjws 

As wiili die results ^xige, die list of pages which match the 
search is familiar Some search engines let you customize the 
elanents of the items on this list, which leLs you malch the layout to 
the daia you tiave. For example, some sites Iwe useful URLs which 
give some context to die page, while others are just conRising, 
Other feaaires may include 


• a ranking oumlx^ or gratihic indicator of how well the engine 
thinks die page m^itches the search terms 

• a file nKxiifiration date (in iwodigil US date fonnat: 09/16/99, 
four-digit year-first fomiiit; 1999-09-16, or some other fomiar) 

• a file size (test in K, Kilobytes, rather than bytes) 


December 1999 • MacTech 


Remote Searqi See\tces for Web Srriis 


77 




























































[vtb iitE search a I S^r^h J e llhiiSil*Ql^v 


&9fiw»irtj 1 " lOflfflhytiS?nwtciB*, bast(tmcn##nr»i, 
AlYlMlUfaEilCi 

... la rtocTacn I neferhi drO Eai i etp^ vT I^Tach ISK FFEI 
r4cT«cb OE^i I u Pr4flr4tiifntr> ci^ii i4Ab» Job p*^no» i... 

... laH kTkHIM icTichCatiespyBfriicT«clvfllSKfAtE 
KhTkIi Gfil hu Pragrtmudr * t^l U&ft Job Fvbtlr^t * *< 

n<ii 


noeDw-1 OwMiapr N*wa ^reb Hk PrbqfbRi' 


nocDm^^ 1 DHvalbftr Nowi Snrbb 1^ Proq/ur 


Updating; the hidex 

To ketip your st%\rch index synchronized with the content on 
your site, you’ll need to set up some kind of update sdiedule. If your 
site changes rarely, you can tell tlie sejvice when to le-index. 
However, if your site ch;mges more often, yfxi will want to set up a 
scheduled ufxiate. 


InlmSmiTh rasull sboiidnff iicrm ?mth URL. size and update date 


If you have carefully written META DESCROTION tag (X)ntenis 
for each of your pages, so they'll mnk well and kK>k great in 
webwide seiirch engines, you will probably want your site .seaah to 
dLs|)lay them as well. Be sure to t iKxxse a remote search service tliiit 
will show these. 

Otherwise, some seivices do a gcxxl jol> of extracting useful 
text, w hile others jusi grab the text from the top of the page. 
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SmrcbfMian m^nll showing selected text extractedJnjm Images 


.Some seivices exuact lines containing tJic searcli lenns and/or 
highliglit the words w^liich match die seardi temis. 



Atomz resuil shouiftg items iidib Kp text and maicbing twd 


CVKIi A.ND FEEDlNti OF YolM Srm SF..4RCH 

Althougli die remote se^irch .service is aiking care of tlie server- 
side of things, you still have to keep track of tlie status, e\^en if it's 
just to make sum ifs still ainning, although these services have been 
fairly reliable s<i far. You should also [xrrlfjnii test ,se;vrciic‘s, some 
that you do every time, others that check new- infbnnation on your 
site. And, as you change die layout and design of your site, make 
sure that die search form and lesulte page rchccl tliese changes. 


Watching the Searches 

Analyzing your search log or report can teach you what your 
visitors are kxiking for — it’s like having li free, automated 
market research survey. For example, if you have a movie site 
and cvcry'one sLarLs searching for the Blair Witch Project, you 
know it's hot, and can make sure you have gtxxl infonttalion so 
tliey don’t go somewhere else. 

Select a report: 

Q Host Popular Searches 
Q Most Frequent Visitors 
A Searches that returned NO Results 
O Browse Raw Search Data 

Hov far back would you like to look: [ Past Month ^ j 

i I Go j 

SeairhHnlHm Re}H>t 1 0 }ttkms 


How m CmxysE a Remote 8f:arc:h StitviCF 
Read thiough the listings alxive, and try out the .sc^arch engines 
in the Search'fools search jiage <http://wvvw.searchtools.com/search/>. 
Think alioui whic:h of the features we descrilie is viral, and which 
yc?u can live without (its like buying a air). Then try oui two or 
tlircx^ that have ilie most impoitant elemetits, and see how well they 
fit with your site. 

Prooict Speclaj. Featlires and Issues 


Atoim 

• Advantages; A vety powerful and configurable seivice, 
provides lots of control over indexing, I'ollows complex links 
nicely, indexes PDF files, has many search (options, and 
provides good schedules for updating. Tlie results page and 
listing layout is entirely configurable using HTML and a 
sim|)le tag-based scripting language, and there are no banner 
ads on tlie resnlts [lage, just an Atomz logo. Free to 500 
pages, paid version for mcjre pages, 

• Disadvantages: free veraion will only index 500 pages, index 
ignores ‘"NOFOllOW” tag, seardi finds every |xxssible match, 
finds plurals and cxlier word fomis, by default, retrieves 
synonyms and soiinclalike words: just ftneis tcK> mtich! 

FreeFind 

• Advantages: Allows you to index multiple sites (up to 32K of 
1ITML daui), update indexes otlen, handles complex links nicely, 
llie search form lets users choase to match “any words” or “all 
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If you rfidn't know then, you wilt now, Introdudng MacBuy.com, The first and only comprehensive buyers 
guide from the editors of Macworld magazine; with MacBuy.com yoo'U know,,. 


which products to buy. And which to avoid. 

The best deals on the Web. And where to find them. 
How much it costs. And how much ifs worth. 

www.macbuy.com 

The Macworld Buyer's Guide 


As Easy as 1-2-3 
Whether you're searching for a 
product review or finding the Pick 
Of The Day, it's easy with 
Mac Buy. corn's clean user interface 
and intuitive navigation. 

Convenience and Value! 

The latest and lowest prices from 
leading Mac resellers. Pius, 
convenrent Links to their sites so 
you can purchase the product you 
want instantly! MacSuycom tells 
you how to shop smart. 

Powerful and Easy-.,, 
to-use search engine. You can 
search by product or vendor name, 
or use the Power Search button to 
search by multiple criteria, such 
as rating and price. 

Support fnom Apple 
Literally. Built with Apple's 
WebObjects, MacBuy.com is solid 
as...welt a rock. 


from tbe publishers of Macworld moga£ine 

[com 


MacBuyf 



Get ft fight. 




































































words'’. Nice adminLStrc:iti()n wiznrcl interface walks through the 
options. Free, w\\h advertising. Id 32 MTJ of HTML tcxL 

• Disadvantages: llaancr ads on result page, not many useful 
oj^tioas for customization lesults page or matched iraus, 
sometime the server is slow to respond, no indexing reptirts, 
limited .scaicli reports. 

IntraSearch (WhatlJSeek) 

• Advantages: AIUjws you Lo index multiple sites, good 
indexing of complex URLs, search finds only pages which 
march all search words, wall update once a week. Free, with 
advertising, to >00 page.s. 

• Disadvantages: Ignores robots.txt, which is usually an 
uncooperative move; not mudi results page customizing 
possible; index report is the ‘"site map"; there is only minimal 
search re|Xjrting. 

MondoSeareh 

• Advantages; g(K>d willi complex links sudi as redirccLs and 
framesets: sliow^^ frame page results in context; leLs admin 
controls speed of indexing; .search form can include choicx-? cjf 
"any words” or ""all words"', liandles extended Roman efciraLtcrs, 
marks pages by language, unusual results fonnat “ show's pages 
in categories, otherwise results pages layout is very flexible; t^an 
lie customized for any language; kxxil seiver versitm available. 


usm. feitife Mm 

Slit Ufa 


SMrcIi 

Sfvoh. Mv-Ij IJvaiir if Iwfi 

m & ar i» 

fnitid. 59 |f^i^ 

OwivI 11 [4^ nmMiK bath 

firm iPMrdi r o « 


^ f f 



Kflilrd L... 


' 4h»« 

a TflgLf InVwnni ^ , 

* gtif Kt, 

All v«rdi 

07JZ5.g9 

0TJ3.SS 

ft eil9*!FjirV« . . 

awl Artailn abMil Vib^itr R: 

AU 

An wards 

AH wpdt 
ri»i 

07 25W 
07.Z3.99 
07 15.99 
07 

ftfvob TmH Rfpar^ 

Alj var^ 

07^599 


MoTidoScafvh Category ResiilLs 


• Disadvantages: no huilidn update schedule, browser 
administration somewliat disorganized, very iruxJal (you musi 
click OK iDefore changing pages). Paid only. 

PicoSearch 

• Advantages; good with complex links such as redirects and 
framesets, tends to follow many links. Excellent index 
reporting, especially ifie live online version. Recognizes 
extended Roman characters and can be customized to show 
results in many languages including Chinese. Free, with 
advertising, to 5,0(X) pages* 

• Disach^antages: No ufxlate scheduling; you must do it 
interactively each time, search finds every possible matcli, which 


k usually too many pages. Free version is not vciy customizable 
for dcsuIls trages or match items. Minimal search leporting. We 
also saw a distressing error when trying to search a site diat is 
not yet indexed. 

Pinpoint 

• Advantagesi: Very configtirable results ptige design and nesulLs 
listing options, lJi<3n)ugfi index report l)y email. Free, with 
advertising, to 5,CXX) pages* 

• Disadvantages: Some problems following complex links, no 
update sc:heduling so you must do it interactively every time. 
Search finds eveiy possible match, which is often too many 
pages. Problems with extraaing text for page descripiion* 
Almost no search reporting, makes ir hard to Rack usage. 
Server can lx.‘ slow. 

SearchButton 

• Advantages: It’s gtxxl with complex links such as redirects, and 
indexes automaticaliy once a montli. 'the search form offers a 
link to die Advanced form, for power users. The search reports 
are excelleni and tlie servic.e also provides access to die scaich 
tog for even more detail. l-R^e* witli adveitising, to 3,(XXI pages. 
Qxn request nt}-ads versitm for small public-service sites, no- 
advtrrtising paid versitm availafile. 

• DisadvanUiges: May want lo index int>rt frequendy tlian free 
veision allows. Search finds every jxjssible match (even when 
tlial's not w^anted). St^rt'h form HT Ml. t'an lxi‘ hand to locate, and 
the nexulls page and result item tosiomiztidon Ls very limited. 

SiteMiner 

• Advantages: good with complex links such as rediieeLs, search 
finds only jrages wliidi match all search words. Free, with 
adveitising, to 10,0(X)+ jxiges, 

• Disadvantages; JavaScri|it £)niy seaich Ixjx (no HTML), 
f)n)[)lems w itii extended Rtaiian charactei's, tninimal results page 
and result item ciistomiziition, no u|xlate .scheduling, minimal 
search reporting. 

Webuiator 

• Advantages: good with complex links .such as dicnl image 
maps, .search finds £)nly ixiges w'hieh match all search words, 
great results-pagc layout eustomiziition options, autonritically 
updates every two weeks :ind on demiind Free, with logo, to 
S,lX)0 pages: kx:al .server version available. 

• Disadvantages: Complex access system for logging into 
administration site, title problem with server redirects, no 
result item customization, no update scheduling, minimal 
Hearch ref>t>rting- 

As you can see, there s no one search engine that lias all die 

advantages. Which one you sliould ciKxxse de|>ends on your site, 

and your particular needs. You won't know what you like until you 

take a couple of test drives! 
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Result List Required aiid Optional Features 



URL 

“1^ 

dair 

fife 

Sfef 

tesi 


custom 1 

results 1 

noi^ 

Atom/ 

upL 

r>pL 


iqpt. 

1 

mcutfcsc., 
if a^aUalilc, 
ochtTwisic top 

«M , 

match wmbi 

many 

options 



teq 

on 

no 

no 

nicta doe 
if afv^iilabfc.% 
trtJlLTWLSC 
t!Xiraas text 

no 

TKl 

1 

IniRiScarcii 

rt^q. 

no 

aq.,(4 
in K 
year 
ta) 

tv<i 

mm destv 
, iravuilnhk' 

(tn mated) 
(lll^TWlSf 
extmets tm 

iiigliltghtN 
miUdi wifds 
in eximcted 
lexi 

no 

1 

1 

1 

! 

MiindoHeua’h 

rui 

nn 

opt.j 

(ctiok’c 1 
oTiaraiai) 

mi 

f 

in jcctiridai*)' 
on]>; 
mcna dcM;. It 
aajbNe 
otherwise 
ottiaas test 

match words 
lusted 

mam 

optkms, 1 

within 

special 

kxmat 

limits 

Sjicciai 

category 

rtsuli 

Rirmat 

PitxiSeirdi 

rcq. 

no 

no 

on 

()pt,nitt;i 
dc^'.;op<i. 
extma lino 

li^l^ts 
march words 

minimal 

possibb' 

uEUomiiabk' 

inpakJ 

version, 

PifUAHiit 

opr 

opL 

OpL^ 

(2-digit 
US) 

in K 

vcr}'?ihofll 
cryptic bits 
of text 

hjgllllglLtS 
match wocib 

ray 

Custocni/ahk.- 

cxcqJt 

cxnaa 

irregular 
pagetoi 
' di^lay 

ScsudiBuunn 

no 

req. 

Kil 

(2 digit 
US) 

m 

extrjcis 
‘best’' text 

rK> 

no 


SHcMter 

aq 

1 Kq 

no 

no 

sometime 
exinias''lx'St" 
text 

hiithlights 
match wonfe 

no 

tktesn't 

a;wa)'s 

sitowa 

descriittfon 

V^bjoflior 


1 

1 1K> 

InK 

Ci^mracts 
‘best" text 

‘match info" 
link 

no 



Maintenance Features 


■w 

^pdMbV 

rqinit!i 

notes 

Acomz 

on daiwntl.once a week, 
sdKdutcd in 4 hour slots 
(knows aLuxji time zotics) 

count of scaiehes, search winds, 
scoieh |5hiase, ayg. lesults 


FreeRnd 

choice of mundily. eray two weeks, 
thy of the week, every day; can set 
the time (knows ahtmi time imnes); 
will nor rc intlcx inactive sites 

seasebes per day, keywords and 
number of seardies ovw thnCi recent 
tpxTy phpsts 


intraScardi 

automatic uptSatc up to once a week: 
im TCquest apptox, every 10 days 

number of searches pcfftirmed 
in last 7 dap 


MondaSeaich 

not automatic, ofi dcnxuid only 



Pict^icardt 

imt autornatk; on demand cjtih^ 

top 20 terms, number of scardics. 


PinEAimi 

nm aincmiTk', mm manually trigger 

hcTw many seardies were done 
per day 


Scardifhttnn 

aiitomatk.OfKX a month; omk-majKl 
lip to hmr times a month 

pupuhr searches,no results 
searches, roost frequent vratOfS; 
can sec past 24 hours, post week, 
past month,Of all 

con sec log of 
all searches 

SihrMfoer 

oai demand,‘as often as >'ou like" 

i 

most recent searches, 

(no way' to tdl if they were 
successful) 


Webinator 

automatic, every' two weeks, 
and on demand 

no 
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PROGRAMMiniC 

TECHNIQUES 


hy Kas 'fhomas 

Adding PDF Support to an 
Application Using PDFLib 


A great freeware library 
makes adding PDF 
support to an app easy 


AcIoIk*'s Portable ITocument Foniial 

(PDF) li;i 5 become a stafidard for 

elcaninic dcxiiment intercliani^c, based on 
its alnlity to deliver gniphically rich, 
stAictiired content in a c'oasistent manner 
acRxss multiple operating environments. 
Almost every large wel’) site oflers al least 
some PDF-based content, making tlie 
Acrobat fieader one of tlie most poptilar 
downioatls on the web. (Inctedibly, Adol^e 
claims to average some 100,OtX) downlcrads 
of the Reader from its web site per day,) 

Because of its support for vector 
graphics, font emi-iedding, hyjx^riext links, 
and other advanced features, PDF Is a 
powerful, far-reaching docurneni standard. 
But tliat also means it’s a a^latively complex 
standard (for details, see the SeptemlxT 
1999 MacTech) — and tliemfore far from 
trivial to support in an application. 

From a programming standpoint, one 
ran talk alxiui two types of PDF supptjit; 
supjx>n for PDF reading (import), and 
support for l^DF uriling (export). As witlj 
TIFF, QuickTime, and tiiany other ajmplex 
fcjitnaLs, it's much easier to provide iirite 
support tlian read support, because a 
comprehensive PDF-read tiipability means 
implementing the entire rather pondenous 
PDF sfxTifiaition (see hrtp://partners.adobe.- 
com;asn/developer/PDFS/TN/PDFSPEC.PDF), 
whereas a write-only facility may mean 
implementing only a tiny subset of die PDF 


spec “ the subset of jxutJLular inteiest to your application. For 
example, if your application primarily outpots ASCII text, tlieie Ls no 
need to imj^lemenl graphics-emliedding, halftoning, transfer 
functions, etc, in older wj support PDF output. 

Adding a well-defined PDF^output capability to an 
application ettn be suri^risingly quick and easy, if you make full 
use of existing tcxils. For this article, 1 decided to add PDF export 
capability to BBEdit (tlie fxipular text editor), with the aid of a 
third-|>any freeware PDF library called PDFLib. Source code for 
the BBEdit plug in accompanies this article, (Tlie txmnplete CW 
Pro 5 project, including PDFl-ib and its source Files, can Ix.^ fouml 
online at ftp://www.maaech.com.) But l>t:fore we stan talking code, 
let's take a moment to review the basics of the PDF format, {hen 
lcx)k at wliai kinds of development patlis one might take to arrive 
at a PDF-export cap;ihility, and wiiai sorts of tools are currently 
availal>le to make die programmers lile ea.sier. 

PDF Fundamfpctals 

Atk)lx?’s Portable DtKumeni Poniiai is a kind of gigantic, special- 
purpose niarkui) language, bised largely on Postscrifii (the postfix- 
notation page description language) Ixa lacking Postscriiifs contnil- 
flow conslmtts. PDF is a .sort of “unnilled" version of Pt^tsaipL in 
which aU graphics operations are inline (ratlier liian mlying on Icxips) 
and therefore speedy. Ixxikups and inck*xing o|XTatioiLs are likewise 
fast Ixxiause of Pt)F”.s extensive u.sc of axsotiative arrays (or 
“dictionaiics," in Adntx.* partince), otganized into Ucvlike stmttures in 
which all nodes liave fcwaid and/or Ixick-pointeis to oilier- ntxies; 
[>lus, every leaf (of every kind) has an enir^^ in a gimt ‘xieF Uible, so 
diat tile oiTset of any tihjeti am lie liKiked up instantly. 

Pages are oigani^cd into sets of objects that describe a 
jiage's resources and cxinicnl. The obfects are liuman-readable 
ASCII and ItKik like: 

4 0 obj 
«/Type /Page 
/Parent 1 0 R 
/Resources 8 0 R 
/MediaBox [0 0 612 792] 

/Contents [5 0 R ] 

» 

endobj 


Kas Thomas is a freqtieni contribuior to MacTet.h and author of a foohcDniing O'Reilly book on PDF-l-jased web 
programming. You can reach him at kt^.icmronTis.eoin. 
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Featuring incisive reporting from Macworld.com, MacCentral.com, 
MacWEEK.com, MacGaming.com, and iMacworld.com. 

It’s the ultimate destination for Mac news and information. 
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In this Oise, the top line tells us were dealing with Object 
No, 4, revision zero. The object is a dictionary object, as 
indicated by tiie douiile angle brackets, « and », enclasing die 
olijeci. The Rrst entry in the dictionary is a label telling the type 
of dictionary (in this case, a Page). The next taliel/value pair is 
a backpointer to the parent of this tibjea, namely Object No, I, 
(A reference ending in 'R\ such as 1 0 H. is a /xtinter to an 
object.) The next entry tells where the page’s rcxsources can be 
found (namely, in Object No. 8.) The MediaBox entry gives the 
pages dimensions, in points (72 points to the inch); here, 612 
by 792 mciins dial we're dealing widi a standard U.S. Letter-size 
page (8,5 by 11 inches). The final entry, in the above example, 
shows where the page’s Contents (probably a stream object) can 
Ik found, namely in Object No, 5, 

When text needs to be displayed on a page, it is packaged 
inside a stream object. Tiie stream object will contain the actual 
ASen or Unicode strings that need to be displayed, along with 
various Postscript-1 ike operators, such as m for "mo vote 5 " and Tl, 
for "set leading," dial control the stroking, filling, and positioning 
of die individual letters or glyphs. 

Wlien all of the objects in a PDF file have lx:en written, a 
cross-reference (‘xref) table must be inserted into die file. The 
entries in the 'xref table must conform to a fixed format (see my 
article in MacTeeb for SeptemiKr 1999) and they mu,st contain the 
exact byte offset [mm die start of the file to the object referenced 
by the entry in question. The integrity of the PDF document resLs 
on die accuracy of the byte offsets stored in the 'xref table, Since 
most of diese offsets aren't known until llie objects are written, 
the 'xref table usually gties at the end of the file. (This isn't 
always the case, however. So-called "itnearized" or “optimized" 
PDF files have an ‘xref table at the beginninif of the file.) 

Several things siiould be obvious by now. First, there is 
nothing freefonn about a PDF file. Unlike H’l'ML, a PDF file is 
higlily structured, with many pointers lx.iween objects. Byte 
offsets matter a greal deal and must be accounted for when the 
file i.s written. Secondly, PDF files are largely self-contained, 
bringing with them their own font resourt'es and embedded 
graphics (rallier tlian linking exterruil resources). Thirdly, to 
write a PDF file means lots of string manipulations — somediiog 
dial, frankly, ANSI C is a little weak at (compared !o^ say, Perl). 
Beyond that, the PDF specification itself (currently ctmtained in 
a 518-page, l60,0(X)-word document) can be difficult to read and 
interpret. Supporting PDF export in an application WTitten in C 
can Ik a bit tcxJious, to say the least. 

Third-Parit Librarirs 

It helps, in a situation like this, to Ixr able to call on help 
from third parties, raliier than reinvent the wheel yourself 
Fortunately, some excellent tools are available to make your life 
easier. Among fhe general-purpose libraries are available for 
adding PDF handling capabilities to applications arc: 

1. AdoiK's PDF Library, also known as PDFL40; for use wath 
Code Warrior on the Mac, Visual C++ 5.0 on Windows 
platforms, and gcc 2.8 on Sparc Solaris. 


Adding PDF Support to an AppT.icAnoN Using PDFLib 


2. Tile ClibPDF Library, by FastJO Systems (htk3://wwwiastio.CQm); 

an ANSI C library, compilable on just alxiut any platform. 

3. PDFLib, by 'lliomas Merz Chttp://www.pdfllhcoiR); a C 

library, with bindings for C++, Java, Perl, Python, Tcl^ and 

Visual BASIC, 

If you're a Perl user, you'll want to check out PDF-on-the- 
Fly, a Perl library available from the University of Nottingham 
(http://www,ep.cs.nott.3C.uk/pdf-pl/download/manuaLpdf), as well as 
txt2p€lf. a library from Sanface Software (sanface@sanface,com). 

Adobe’s PDFL40 is without question the most powerful and 
robust library available, relying as it does on the Acrobat 4.0 
eodebase. With PDFL40, you can read, display, and write PDF 
from your own application. But unfortunately, PDFL40 isn’t free 
— and even if you can aff< ird the licensing fees, you may not be 
allowed to use the library. As stated in Adobe’s literature, 
PDFL40 Ls selectively licensed to developers who are creating 
“products dial are strategic to Adobe's matketing plansT In odier 
words, Adobe will review your development j:)lans carefully, and 
// tliey like what you're doing and if you agree tfi play by 
AdolK’s rules, you may be allowed to pay to use llie library. 

Outside of Adobe, the two be.sr-known C libraries for PDF 
support are CIJbPDF, by FastIO Systems, anti Thomas Merz’s 
PDFIlb. Both come with Full source code and can be used 
without restriction (or virtually without restriction) by individual 
developers who are creating freeware or personal-use software. 
(Corporate users and commercial develofKrs must take out a 
license, at significant cost.) ’Die main restriction of die.se libraries 
is that they support PDF outpui only. They will not help you read 
PDF or display a PDF document on die .screen. The same is mie 
for die two Perl iibraries: PDF-oo-tlie-Fly and txt2pdf are 
basically write-only. If you need to put PDF up on the screen, 
you’ll probably want to look into an open-source program called 
GhosLscripL (http://www.a.wiscedu/'-ghost/index.html), which started 
as a freeware PasiScript interpreter, written in 1988 by L. Peter 
Deutst'h, founder of Aladdin Systems. Starling with version 3 3, 
GiiosLscript has been able to read and display PDF files in addition 
to PostScript documenLs. With version 4.0, Ghostscripl added 
PosLstTtpt-to-FDF conversion (i.e., Distiller functionality). Because 
die ctxle is generic C, Ghostscripl has I Ken successfully ported to 
most platforms, including Win32, OS/2, MacOS, Unix, Amiga, 
VAX, etc. (An excellent PDF-I:)a,sed Tnanual for Ghostscript is 
avaiialilc from Thomas Merz; see http://www.muc.de/~tm.) 

ClibPDF and PDFLib are similar in their capa!)i!ities. Their 
differences are summexJ up in Table 1. Both are extremely easy 
to set up and use. Of the two, ClibPDF is the more advanced 
package in terms of the number of features and overall 
performance. ClibPDF ha.s roughly 170 library routines to 
PDFLib's 88. Many of ClibPDF'.s routines provide advanced 
graphics capabilitie.s involving setting up Cartesian axirdinate 
axes (linear or logarithmic) and plotting data (including data 
stored tn external files). ClibPDF was designed to make it easy 
for pciiple who need to generate 2D plots to create attractive 
graphs on-tlie-fiy in PDF, without passing the data through an 
intermediary application such as Matlab. In this, it excels. 
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PDFUb 

ClibPDF 

Full source code available? 

Yes 

Yes 

Documentation 

64 pp. 

75 pp. 

AI^I calls, total 

88 

170 

Image formats supported CTif,TifT.JPEG,CCnT 

JPEG 

Font metrics formats 

AF'M/PFA 

PFM/PFB 

Thread safe? 

Yes 

Yes 

Bindings for .scripting languages? 

Yes 

No 

Font embedding? 

Yes 

Yes 

Font subsetting? 

No 

No 

Compression? 

No 

Flate only 

Text-justification option? 

No 

Yes 

Vector graphics functions? 

Yes 

Yes 

Custom graph plotting? 

No 

Yes 

Annoiatioas? 

Ye.s 

Yes 

Bwkmarks? 

Yes 

Yes 

Hypertext links? 

Yes 

Ye.s 

Form widgcLs? 

No 

No 

Reenter pages after writing? 

No 

Yes 


Table L Comparison of PDFLib and ClibPDf. 

CLibPDF \s also ilie clear winner in lenns of benchmark 
scores. In a test (conducted by a corporate user) involving the 
construction of an intricate 156-page document filled with 
engineering information, CLibPDF produced a 257,027-byte 
PDF file in just 15 seconds. By ntmparison, Adobe's Distiller 
l<K)k over three minutes to pr^xluce a 197,548-byte file; Adobe's 
PDF Library took 54 seconds to create a 284,565-byte file; and 
PDFFib t<K>k 84 seconds to yield a 1314,084-byte finished 
docuEncni. Tlie filesize disparity is due to the fact that PDFLib 
uses no text compnessit^n, whereas the others do. (Adobe uses 
a combination of LZW and Plate compression. To avoid patent 
infringement issues, CLibPDF uses only Plate compression.) 

Wherefore PDFLib? 

Why would anybody use PDFLib? For one thing, it's the 
only libntry that ixjmcs with ready-made bindings for Perl, 
Python, Tcl, Java, and (on Win32) Visual BASIC. 'Ibis is 
incredibly in 4 X)rtant if you're a wcl) developer who needs to Ix" 
al)lc to serve dynamic PDF — PDF pages generated 
automatically, t>n die fly — for web clients. Dynamic PDF pages 
(via Perl, say) are easily possible using PDFIih. All you have to 
do is link the PDFLib shared lii^rary with the PerlSlub file (which 
is part of the MacPerl distribution suite) and follow the calling 
conventifins given in Ihomas Mer/'s excellent documentation 
(which has example eexie listings for all the different bindings). 

But wbai about the big file size&Fyo^x ask* It’s true that, as of 
yet, PDFLib docs not have any compression support — for text. 
For imagery, PDFLib supports JPEG, GIF, TiFF and CCITT 
bitmaps, all of which are compressed* (Acrobat Reader handles 
the decompression automatical iy.) CLibPDF, on the other 
hand, only handles JPEG emlxdding, unless you pay the 
license fee ($1,000), in which case you can get TIFF support 
(among other features)* 

Dkcfmier 1999 • MacTi-ch 


PDFLib's lack of text coinpression can result in big files if 
you're mainly outputting big gobs of text. But if you will be 
serving dynamic PDF web pages (or creating other fairly small 
text files), you won't suffer for not having compression, since 
small text streams often compress poorly — or even grow, 
rather than slirink — at pack-down time* 

It turns out PDFUb Ls ideal for generating small to 
medium-siaed text-based PDF documents, because — unlike 
Adobe's own pniducts — PDFLib won't automatically embed 
fonts (ir font subsets for any of the standard 14 core Type 1 
fonts that are included with Acrobat Reader (the Helvetica, 
Times, and Courier families, plus Zapf Dingbats and Symbol)* 
'Ihis can be important, because although a small PDF file may 
or may not shrink significantly with compression turned on, it 
will definitely grow when fonts are embedded unnecessarily. 

An<)Uter reason to use PDFLib is that it's nominally .smaller 
and easier to learn than CLibPDF (although the latter Ls by no 
means hard to work with). And should you later need to pon 
yottr code to a scripting language, you c'an reuse your c<xle 
with very little work* 

Adding PDF Export to BBEdit 

BBEdit (by Bare Bones Software) is one of the most popular 
ASCII editors on the Mac. Features like regex-lxased (regular 
expression) search-and-replace, robust HTML tcx>ls, and neck¬ 
snapping performance have endeared BBEdit to thousands of 
loyal users. But when it eomes to producing eyepleasing output, 
BBEdit isn't exactly a killer app. Wouldn’t it Ik* nice to be able 
to save BBEdit documents as PDF files now and then.^ PDF is 
easier to look at (and print out) than raw ASCII, any day. 

It’s not hard to add PDF export to BBEdit, because like so 
many software products these days, BBEdit supports a plug-in 
API dial allows third-party programmers access to tile main 
program's data. Tlic BBEdit plug-in API is well documented and 
has hotjks u> many utility functions for retrieving the text from 
diKuments, niitnipulating user selectioas, etc. Space doesn't 
[>ermit a full tutorial on writing BBEdit plugdas here. However, 
we mil have space to run ihrtiugh die 200 or so lines of C 
rec^uired for a short plug-in dial lets the user save an open 
BBEdit document as a PDF file. 

The Code 

Hie BBEdit plug-in interface requires that we compile an 
old-fashioned Ckxle Resource of type BBXT’ and creator 'R'ch'. 
(The cremator type can be anything you want, but if you slay with 
'R*ch', your plug-in will liave the icon associated with BBEdit 
extensions.) Note dial the name of your'BBXT resource (not the 
filename of your plug-in) us the name that will appear in the 
BBEdit ’Tools" menu at runtime. 

The main() routine for our PDF-Output plug-in, shown in 
Listing 1, is typical of most BBEdit extensions. It shows dial our 
resource is called with a pointer to a BBEdit structure called the 
ExternalCallbackBlock; a WindowPtr a.ss<K:iatcd with the frontmosi 
user window; a long int containing various flag values lo convey 
information about the .state in which BBEdit is in; and pointers 
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to ApplcEvenfs. All we do in inatn() js call EnterCodeResource(), 
check our ilags (and the WindowRr, for validity), then call 
bhxtGetWindowContentsO — which retrieves a Handle to all tfte 
text in the frontmost (active) dtKnament — Ix^fore landing the 
text ofT to our ftltering routine. When weVe done, we ciilt 
ExflCodeResourceO and that's all she wrote. Easy as pi, 

Listiug 1: niain( ) _ 

main() 

pascal DSKtr jiiain[ExternalCanbackBlock Valtbacks. 

WLndowPtt w, 

Iqng flags, 

^ A^jpleEvent 'event, ApplcEvent 'reply) 

OSJErt err = noErr; 

EnterCodeRes<3urce () \ 

\ 

Handle text: 

WindowPtr newWindciw^ 

if {Jw II (KfWIndDvCpen £: flags — 0) 
return err: 

text " bbxtGetWindowC<intents(callba€ks,w): 
err ™ pdfTranslate(eal 1 backs*text,w): //write pdf 

I 

ExitCodeResource C)i 

return err; 

J 

We don’t actually do anything with the ApplcEvenl 
pointers in this example. In a real plug-in, these poinier.s 
would be the mechanisni by which your plug-in could he 
controlled throtigh OS-level scripts. Most of the time, though, 
these pointers will be nil. In all versions t>f HBHdit Lite, for 
example, the pointers are nil. 

Hie real heavy lifting txrurs in lasting 2, where our 
POrUb routines get called. Before using any other PDFLib 
routines, we call PDF^^newQ to initiali^^e die lllirary. ('Phis results 
in a numl’ier of large dau structures i>eing allocated and hlled 
out for us, Ixtiind tlie scenes. The principal data structure is 
.something called, appropriately, a PDF. A fxnnler to this dtta 
structure must be passed to every library routine so dial PDFIJb 
can keep track of the PDF dcxoiment’s state.) At the end of die 
roudne, l:>efore exiting, we call PDF„close() lo clo.se the 
connection to the PDFLib library, freeing all resources that were 
allocated earlier. 

listing 2: pdfTranslatef ) 

pdfTranslaict > 

OSErr pdflranelatet ExternalCallbackBlock 'callbacks. 

Handle theText* 

WinddwPtr w ) I 


PDF ‘p » nil; 

Int font.J; 

long i.linecaunt.textLength: 

OSBrr err * noErr; 

Boolean titaeForNewPage = false; //sentind 
char 'input. 


filename[32] * 

buf[TAB_VALUE 'CaARS_WIDE]; 
unsigned chat 'out = buf: 
char okiineKudersi) “ 


p = PDF_new(); 

if (p = nil) return 1; 

[JLockHi(ttieTcK t); 

FudgeName(callbacks. filename,w); // create outfiJc name 

// open the new TOF file 

if EFDF_cpen file(p*[cbar ')fileiiaiue 

fprintf(stdfirr. "Error:cannot open temp.pdf file.\n’’): 
exit(2); 

1 

// chesc lines arc opUoniil; 

PDF„yGt_info{p,"Creator“."BBEdit PDF Exporter plug-fn"); 
PDF_set_iiif 0 (p * ’^Author **. **Kas Thomas "); 

PDF„aet_iiifo{p."Title","Hello worldr): 

FDF_begin_pagc (p, letter^vidth, letter Jie 1 gh L); // start a paj|t: 

// find a base-H font 

font ^ PDF_findfont < p,"Times Roman*,"default"* 0); 
if [font =-l) I 

fprintftstderr ."Cotildn*i set footlW"); 

HUnlock(theText); 

exit(3>: 

} 

PDF^setfont (p. font, FONTSIZE); // sin font & ske 
POF_set„leadingCp* LEADING) r // lict Hnc spadng 

Pl]F_s et_text_pC)S Cp * TEXT_STAKTX. TEXT.STARTY3; 

PDF showCp*" "): 

input = '{unsigned chat **)tbeTcxt; 
t ext Length = Ga tHand 1 eS i ze {UleText); // (h>w kmg is our text? 

// for cv^ tharacter... 

for (i “ O^Hnecount = 1; i < textLength 1 r ) 

// fetch the current line.., 
for (j = 0, out - buf: 

j K CRARS_WIDE - 1 ifit L < textLength - 1; 

j++) 

I 

*outH “ Input [1++]; 

if (lnput[i-lj =- TAB) [ //miiSi handk:Ikhs uuiMiIvcs 
Int k: 

for (k - 0: k < TAR VALUE: k++3 
•out++ = SPACE; 

! 

if (input [1 I] “ CARRIAGE mnm) //break on (JR 
go X o Te i ml na t eLine; 

I 

//g£'t to next wend ending 

while (strehr (okUnfiEndcru. input [i 13“NULL) 

*out+^^ = input [i-H-J: 

lerminatnLfnt!: 

•out - 0x00; //makeiiaCstriOi? 

PnF_continue^text (p, buf); // write to PDF fik 

if (linecountH- % LINHS^PER_PAGE — 0) ( //end of page? 
PDF_end_page(p): 
titneForKewPage = true; 


If (tiraeForNewPage U 1 C texlbength - 1) ( //moiutodo 
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timeForNcwPagp “ falM; 

PDF3e£iri_|>agG(p. letter _wldth. letter Jig Ight} \ // new piige 
PDF^set fontlp Jcnit H Fern’S! ZE); 

PDF_Eet„leading C p. LEADING)i 

PDF sGt_text^poa{p.TEXOTARTX.TEXT_START¥); 

PDF_Hhow{p." *); 

I 

1 // for i 

PDF_end_page (p) ilf 

PDF close(p): // dose PDF obj 

IHInlDckfrheText) i 

return err; 

J 

TIr* PDFlib routine PDF_open_file() will create a new file 
for us (in the cuneni directory) if we p;iss it a pointer lo a PDF 
struct along with a pointer to a filename string* Note that the 
filenarttc string must lie a C string* We create the necess^iry string 
(consisting of the original file's name, plus the extension “.j^clF’) 
in 11 custom iiJility njutiiie, FudgeNameO^ See Listing J* 

After creating our (empty) output file, we make three 
calls to PDF_setJnfo(}, to set the file's Creaior, Authtfr, and 
Title* 1*hese strings will show up when the user cioes a Get 
Info cm ilic PDF document wliile viewing it in Acrobat 
Reader. It is not strictly necessary to call PDF_setJnfo(), since 
PDF hies are not required to have “Get Inlo" info; but 
PDFIJh makes creating these tags easy. (Again, though, note 
the use of C strings rather than Pascal strings.) 


l'iidjR'N;invc( ) 

// Get the current FlBEDit fiklt naitK.:idd*.pdrto it, put it in ‘str’ as a G suing. 

void FudgeNamelExlernalCallbackBlock *cb* 

unsigned char 'str. WindovFtc w) 

I 

Str255 fKatne: 
short v; 
lung d: 
long lengthr 

char endingtJ " \ W*p* 0x00 h 

bbxtGetDocInfo(eb*w. rNaff»*&v.frd): 
length *fNaae: //Pisc-jI siring 

// now we en;atc Ji C suing: 

BlockMovetfNamei1♦str, length); 

Blodd1ovc(cnding.rtr+length.5): 

I 

To begin a PDF page, we call — what else? — 
PDF_begin_page() with, in this am, the predefined values 
letter_widlh and ietter_heighl* whicli correspond to the 
dimensioas of a standard U5. letter-si^ed page. (PDFLib also 
has predefined coastants for A4, legal, and many other page 
si^es* Or you can use your own custom dimeasioas.) 

Next, we come to tine of the most important c-alls tn tliis or 
any routine that uses the PDFUb library. Namely, we do: 

font PDF_f i rid font (p, “Times-RoHian**, “dc fault **.0); 

The purpose of this call is to locale font resources for 
our tlocumem and specify an encoding lor the font* (Here, 
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we^re giuimnteed to get a viilid return value, Kince Times- 
Roman 15 one of the base-H fonts that Acrobai Reader can 
always use.) Allowable encoding vatyes are pdf doc, 

macromant macexpert, winansi or defauH (see Secikin 3-4.2 
of Thomas Merz^s excellent PDFLib manual). In our case, 
we're conieni 10 let PDFLib determine I he most suitable 
encoding based on the environment, so we indicate this by 
setting the third argument to “default.” (The encoding must 
be speLified as a C string.) 

The return value from PDF_findfont(), if not equal lu 
(an error), will be needed in .subsequent calls involving 
typesetting parameters, such as PDF_setfont() and 
PDF_set Jeading(). It’s important to understand that the value 
returned by PDF_findfontO is not an enumerated value or an 
index into a fixed lookup table. Rather, it's an index into the 
font cache of one particular PDF docuiiient. If you're working 
with two documents, one may store U'imes-Roman in its cache 
at a different index than the other; hence, PDFJindfontO may 
return two different values for the same font, based on the 
font's use in two different files. Don't just assume that if 
PDFJindfontO returns T* for Helvetica, that therefore Helvetica 
will always be referenced by a font valtie of *V. It may only 
be ‘T for one file, in one particular context. 

Having gotten a valid return value from PDFJmdfontf), 
we use that value in a call to PDF_setfontO. which attaches 
the font resource icj the PDF file and also lets us specify the 
point size of the font. The point size can be any Ooating- 
point value: 24.0 for a small Iteadline, say, or lU.O to 12.0 for 
regular body copy, etc, (Fractional value.s like 13-4 are fine, 
too.) We can similarly set the line spacing with 
PDF_setJeadingO. Typically, the leading is close in value to 
the point size of the text. If you specify the leading as 1,2 
times the point size, you won't go far wrong. (For double- 
spaced text, try 3T) or 4.0 times the point size.) 

The lilirary function PDF_set_text_pos() lets us posititJn 
our “pen'’ or insertion point at any x-y position on the page. 
Here, you have to remember that in the PDF ctKjrdmate 
space, (0,0) corresponds to the lower left corner of the [>age, 
w'ith 'y' increasing in the up direction. Also, recall I hat in the 
PDF world, the default unit of space is the typesetlcr s [mint, 
which is 1/72-inch. Thus, if you want to begin writing at a 
distance of one inch from the left edge of the page and ten 
inches up from the hotttim, you would specify coordinates 
of (72, 720). 

To write text on a PDF page, you can eilher make 
repeated calls to PDF_set_text_pos() and PDF_show(), 
specifying new line-slarl coordinates eveiy time, or else 
make one call to PDF_show(), followed by repeated calls to 
PDF_continueJextO. The latter function automatically 
repositions the insertion point to tlie start of a new line, 
using the left-margin and leading parameters that you've 
already specified. This can be more convenient than keeping 
track of line depths yourself. To keep our main loop from 
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having to he a do-while loop, we make a tiiimmy call to 
PDF_show() witli a value of “ “ before entering the loop. 
Then, inside the loop, we just make repeated calls to 
PDF_continueJext(), 

The Main Ijoop 

Our main loop, which is actually a double ne.sted loop, 
deserves commenL The outer loop counts individual 
characters and makes sure that we loop over all the 
characters in the source document, stopping only when | 
w^e've gotten to the end of the file. The inner loop fetches 
one line of text at a time, writing to a line buffer, 1)uF, which 
is conservatively sized at a fixed size of TAB VALUE * 
CHARS_WIDE. In a real application, you'd determine 
CHARS_WIDE dynamically, based (perhaps) on llic point size 
of ilie text or some other metric. For this short demo, weVe 
hard-coded ihe type size at 9-0 points and rhe line width, 
CHARS_WIDE, at 80 via ^defines. The reason our line buffer 
lias to be sized ai TAB.VALUE * CHARS.WIDE is dial Ws 
conceivable that we could encounter a pathological line of 
“text” where every character is a lab. If a Tab is et[ual to five 
.spaces, our line buffer luid better he 400 bytes in capacity 
ratlier than jusr 80, or else we'll overwrite the buffer 

Inside the inner loop, as we gather characters into a 
‘line" of text, we liavc to lumdle Tabs (jurselves, convening 
ASCII 0x09 (the ‘hib character — which is a non-priming 
ASCII value) to spaces. We also check for end-of-line 
characters ourselves. In ime Mac-centric manner, we ignore 
linefeetls and consider ever)' newline to he e(]ual to ASCII 
OxOD (carriage reiurn). Of course, text file.s created on a Unix 
machine won! conform to this assunijiiion, since in the L'nix 
workl newlines lend to be ASCII OxOA (linefeed). In the D(TS 
and Windows worlds, lines end w'iih bolh a linefeed and a 
carriage return: OxODOA. 

Our inner looj^ is constructed in such a way llial when 
tlic number of characters read equals CHARS_W1DE, we bail I 
out and write llie line to the PDF file, l>ut in addition, we bail 
our any time a hard return ((Carriage return) is encountered. 
This leLs us handle lx)th lraditit)nal Mac text files (in which 
lines are soft-wrapped to the screen, with carriage returns 
coming only once per paragraph) as well as DOS-style 
documents in which ei^cry single fine {not just the paragraph) 
ends with a hanJ ret urn . 

rhe fact that there are two ways to fall out of the inner 
loop has interesting consecfuences. Obviously, if we 
encounter a hard return, there's no c|uesrion about what to 
do: we immediately w'Hte the line out to the file. Hut if we 
fall out of the main loo|> because our line has heguri to 
exceed CHARS^WIDE characters, it's possible ( likely, in fact) 
that we've bailed out in the middle of a word! Hence, we 
have to Loseit some coniingency code to read to the end of 
the current word. Hie code tliai does this ltx)ks like: 

// gft to next word cnditij* 

while (strchrColtLiineKndcre* input [i] )—KULL) 

*oiit++ input [ l-H-]; 
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The standard C function strchr() checks to see if the 
second argument (a character) occurs anywhere in the first 
argument (a string), k returns NULL on a miss and non-NULL 
on a match. 

If we fall out of tlie loop because of u hard return, we 
don't need the above code. Thereh)re we can skip around it 
with (ugli) a goto. There are probably better ways 
(stylistically) to handle this situation, but in the interest of 
clarity, i decided to keep the goto, for now^ 

Once we*re out of the loop, we have to remember to 
make our line a C siring (i.e., we must null-terminaie it); then 
wc can call PDF_continue_text(p,buf) to write ihe line. .All that 
remains is lo check the number of lines written, to see if ii's 
time for a new page, and if so, starl a new page. Here, it's 
important to nolc that every call to PDF_begin_page() results 
in PDFtJb resetting its graphic state, which means w'e need 
to specify our type si?:e, leading, and cursor-posit ion values 
all over again. If you forget to do iliis, you'll wondering 
where all the text went on the sectmd and sul>scquent pages 
of your PDF dtKument. 

When we re done, we cail PDF_close(), ijnl<K:k our text 
handle, and return to the calling routine, rising PDF_close() 
actually not only frees up our library-invoked resources but 
also closes any working files weVe left open. So at this point, 
we can consider our work done, and control can return to 
the host process, in this case liBEdit. 

Esvhancemhnts 

In a real-world BHFdit extension, it wt>uld be a good 
idea not only to gtM serious ahom crnir-checking but also 
consider such ilungs as a user preferences dialog and 
support for Apple Rvents (which sluntld include a 
mechanism for suppressing dialogs, so that scripted 
operations aren't hung up in midstream by unanended 
dialogs). Also, the main loop should be wrapped with the 
BBRdit APRS bbxtStartProgress() and bbxlDoneProgress() calls, 
and the inner loop should contain one call to 
bbxtDoProgressO for every line of text pr(H:essed, so that the 
user knows how things are progressing. BBEdit will display 
a [)rogress thermometer aiitomaticalty, suppressing it for 
short'ciuration events, if you use these calls. 

HHEdit's plug-in API also ha.s some handy convenience 
rtmiines for dealing with Apple Events. For example, 
ccmskler what you can do with the following three lines: 

bbxtFindAppl icfitioii(cb. 'CARO' . AappFSS): 

err ^ bbxtLijuficMpplicatioft(cb.*CARO\^apprSS.&psii) .- 

bbxtSeDdOpenUactcb. *CAKC\ nil. true): 

With the argumenLs shown, the First call has the effect of 
SL^arching the BBEdit dehiuli disk for the application whose 
signature is 'CARO' — namely, Acrobat Reader. Ihe seixind 
function launches that applicatifm, and the third function 
sends it an 'odoc' event, instructing the app to open the 
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tlocuinent specified by the FSSpec pointed to by &fss. In other 
words, with three lines of code you can make BBEdit launch 
Acrobat Reader anti display your just-created FDi- ftk! in a 
Reader wiiidt)w. To accomplish this with our owm custom- 
written code (pnjpedy errt>r-c‘hecked) would require at least 
200 lines of additional code, doubling the size of our plug-in! 

In terms of the l*DF-wrlring portion-s of the code, lliere 
are many possible further enhancements. For example, it 
w'oiild be nice to let the u.ser specify page margins, text size, 
leading, etc. by means of a setup dialog. Also, you could try 
justifying the user*s text. PDFUb offers functions for 
controlling cfjaracier spacing^ word spacing, and character 
widths, with accuracy of a thousandth of an em. (An em is a 
typesetter's unit, roughly equivalent to the poini size of the 
type.) You can use the PDFLib routine PDF_stringwidfh() to 
find out liow^ wdde a given text string is. As an exercise, you 
might try developing a justification routine that preferentially 
adjusts word spacing, followed by character spacing, 
follow^ed by character width, each with ius owai w^eigliting 
factor, (For srmie interesting algorithms here, seek out Don 
Lancaster's excellent article on '‘Picofu.stification" at http://- 
www.tinaja.com/giib/picojust.pdf.) 

A PDF-outpufting BBEdit plug-in that incorporates .some 
of these features (and others, such as rudimentary HTML tag 
interpretation) can be found at http://www.aaoforms.COiin, 

CONCI.OSION 

i ho mas Merz/s PDFl.ib library^ offers an excellent way to 
get started in PDF prtigramming, comliining ease of use with 
cross-platform and even crim4i4nguage ponability. It's the 
only PDF library that can easily be adapted for use with Perl, 
Python, Tcl, Visual BASIC, and Java, as well as C/C++. It 
comes with outsuinding documentation, plenty of sample 
code (for all language bindings), and the price — for non- 
commercial users — cani be beat, since ils free. 

Look at it this W'ay: Now you don't have any excuse for 
not puuing PDF support in your appllcarion.s! B 


Interested in writing 
for MacTecht 
Download a writer’s kit 
from our web site at 

www.mactech com 
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by Jeff CJites <online®mactecbxom> 

Thf APACHt XML FR()TEcr 

In iasi month's colunin, we covered the Apache ITYW Server 
and briefly loiK hed on some cHher projects wliich fall undcT ihe 
umbrella of the Apache I'oundation. As fate would have it, right 
after tliat article went to press, the Apache XML pn)jef:t was 
announced. The goal of this project Is to bring the various XML 
development [)rojeas together under one rotT and provide 
feedlxK'k to the various standards Ixrdies from an implementation 
perspective, its well as to ccKirdinate XML-related devekipments 
within other Apache pn:>jecLs, It currently encompasses four su\y 
projetis, covering XML parsers, XSLT stylesheet prtx:es<s{>rs, XML- 
based web puhlLshing, and XSL fonnalLing object pRK:esst>rs. 
Tliese projecLs are variously in C++Java, and Perl. 

The Apache XMLProjea 
<http://xmLapache.org/> 

XML promises to he the Next Big Thing in information 
interchange, hut it remains to be seen wliether it will live up 
to its hype as a successor to HTML. IToiii a [Kililical point of 
view, liowever, the Apache XML project is a very good sign, 
since it has the backing of (and .source-code coniribuiions 
from) several c-orporations, inchtding IliM, Lotus, and Sun, fie 
sure to check out the press release for the full sttrry r>n the 
project and its crsrporale involvemenl. Then, for an uverv'iew 
of both the promise and the hype, take a look at two CNET 
articles, which cover the recent announcenienl of the Apache 
XML prfiject, and give an overview of mdustiy response to 
the growing XML phenomenon, 

xmLapache-org Project Press Release 
<http://xfnl,apache.org/pr/000Ttxt> 

Apache to create XML open-source tools 
<hltp://news.cnet,com/news/0M 003-200^ 1431504.htmt> 

XML to "revolutionize" info exchange 
<hTtp://news,cnet.com/news/0-1003-200-336873.litml> 

ITom a technical standpoint, it isn't clear wliat direct 
impact tliese firojects will have on the Macintosh platform. 
Mac OS X will make extensive use of XML as the formal fur 
many of its configuration files (rejilactng OpenStep’s plist 
format), and t'onsequently includes its own XML parser 
(based tm Jim Clark's expat), .so it’s hard to tell how^ much of 
a need there will be for third-parly parsers. On the other 
hand, some of the other projects could be especially 
interesting, FOP, for iiistance, processes a tree of XSL 
forinalting objects into a PDF document; given dial Mac OS 
X’s imaging rntjclel Ls PDF-based, this .sort of utility could be 
quite useful It is also yet another point of connection 
between the Open Source and Macintosh communities, as ifs 


a technology which could Ik- usebtl to the platform and at tlie 
same time the platform w'ould be an ideal development 
environment for it. 

FOP: XSL Formatting Object processor in Java 
<http7/xmLapache.org/fop/indeK,html> 

Samba Rei>i IX 

A few months back we covered Samba, an open-source 
package which allows UnLx-like machines (including Mac OS X 
Server) to act as file serv-ers to Windows machines. Ai the time, I 
mentioned that Samba didn’t really give yrai the ability to act as 
a client t(> Window's file servers, unless yciii liiippen Lt> t>e 
running Linux, and I hoped that Mac devek>|x.Ts would step up 
and Fill this void. (Tlie package which allf>ws this iscalletf smhfs, 
and it’s essentially a Linux kernel plugin w'hich enables you ro 
mount SMB shares. It's actually not an official part of the Samba 
suite, although it is distributed with it as a convenience.) As it 
toms out, someone ha,s filled this void (akhtaigh they didn't get 
the idea kum me). Sharity, a commtTcial [)rhIuct by Objective 
Development, allows Mac OS X Server and ics brethren to act as 
SMB/ClFS clients, giving them acce,s,s to Window.s file servers. 
'Ihere is aLso Sharity-Ligla, a GPL version whidt Ls hised on the 
above-mentionetl lanux package, but it is no longer Ixring 
developed. They are definitely wtjrth a kxjk to tliose trying to 
sneak their machine into a Windows-dominated selling, or to 
those who just want a |>otLniially more secure aliernative to NFS 
lor their file-sharing activities. 

Sharity — an SMB I CIFS Client for Unix 
<htp://www.obcfev.akPrc)dirB/Shanty.h 
Sharity-Light 

<http7/wvvw.obclev.atiProduct5/shlight.html> 

Be sure to l( X)k anjund Objective DcveloptiientLs site while you 
are then: — they Iwe a numl-K^r of other nifty pioducis. If you aar 
i using Mac OS X Serc^er now, or when you move to Mac OS X .some 
lime in the fuatre, you will lx* c^sixx-ially interested in LaunchB^m 
which is an application launcher and a ^placement tc>r OfxnSicp's 
applicatitm dtxk. You'll also want lo check oui the review' on 
Siepwlsc, w hiclt gives it high marks, 

LaunchBar 2,0 for Mac OS X Server 
<httpi/AAWvy.obdev.akProdEi^ 

First Look: LaunchBar Bela 

<http://vvww5tepvvisexom/Arlide5/News/LaufKhBarReleas^ 

Last but nt)t lea.sl, w'hen you are done with these links be 
sure ttJ wander over to the MacTech Online web pages a! 
<http://www.mactech.conn/QnlinG/>. Mi 
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No Cute 
See-Through 
Green Panels 


Unlike some higMech componies, Zocalo 
isn't reaching out to the moss market. 
We've been serving business, industry, 
and higher education exclusively for 
more than a decade.. So your business' 
Internet traffic doesn't queue up behind 
some kid's game of Doom, and your 
network staff don't have to wait pnliold 
to speak to pur fecHniciqhs, .. 

By focusing on the Kigh-f^ed networking 
needs of businesses,'’V/e've been able to 
build on Internet‘backbone that provides 
better thon 99.995% overall uptime. 

With peering at mgre West Coast 
locotions than any other ISP, re 
uniquely able to route your cornpany's 
critical data around Internet slow-downs 
and trouble-spots. Gur managed 
multiprotocol network is the only one of 
its kind, allowing Zpcolo qlone Omong 


iSPs to offer jFidfive routing of AppleTalk, 
IPX and DECnet between customers' 
officeiANs throughout the world, at 
sp@§ds up to 45 megabits per second. 
We also deliver fully<onfigured 
equipment, proactive customer service, 
on-site maintenance, and a firewall 
custom-built to your specs, oil at no extra 
charge. We take responsibility for your 
wide-area network and Internet 
connection right up to the FDD! or 
Ethernet jock in each of your offices. 

If cute just isn't enough for your business, 
coll our network engineers and find oyK 
why Zocolo is the first choice for 
industriol-strength business netwqdcmg. 


-hi 510 540 8000 

info@zocalo.net 
http ://www,zocalo. net 
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TOYS AND 
TOOLS 


By John C. Daub, Austin, 'liixas USA 


What Makes You Productive? 


Tools and toys to enhance 
your productivity 


A fijw inonih.s ago, the MacToch 
Ediiors asked tlic suhscTibers of ihc 
Macl)ev-1 mailing ILsi to sliare wIUt their 
fellow developtfrs what makes them 
priKliictive. QkjI Uk)Ls, favorite INIT, 
Contextual Menu plugin, whatever 
wonderful things that we create to help 
make our lives more prrxluctive and easier 
Response was overwhelming, and here HI 
share some of the moie j70f>ular items that 
we use — just in lime tor holiday shopping! 

Goes Wnuom Saying 

Witfioui a doubt, there are certain 
ihings that most rlevelopers use and 
cannot live without, 'fopping that list is 
none otlier titan our Macs! From iMac's to 
G4's, none of us get very far in a day 
will lout our Macs. But as nice as those* 
desktop Macs are, 1 have to agree with 
Brian Ihnk that Ihma^rBook's are even 
lx,*Uer [)eaiuse you can ctxle on the couch. 

Wiien it comes to tools, hanlly a Mac 
deveIo[Xrr can get f>y without their trusty 
copy of Metrowerks CodeWarriot; Prom the 
coa* itxils like the IDE and PowerFIant, to 
fringe t(X)ls like ZoneRanger and the 
l^rofiler, software for the Macintosh just 
wouldn’t Ix" the s;inie if no! for CxxieWarrior 
(would it even exist if not for CixlcWarrlor?). 
Cximing in a close second to GxleWarrior 
for ^^must have" UxjI is Resorcerer from 
Matheiuiesihetics Inc. Resoune editing Ls 


fundamental pan of Mac software development^ anti altliougli 
KesEdit Ls free and can gel the job done, it’s difFicult to go without 
Resorcerer for your hardcore development work. Finally, what 
development setup wtxild be complete without a low-levcl 
debugger like the ubiquitous MacsBug from Apple or "‘'Ihe 
Debugger" from Jasik Designs? Of course, tN>se of you that are able 
to write bug-free ccxJe can skip these last Uk>Ls, 

More For hie T(K)e Chest 

We certainly cannot live without otir core tools, but they 
alone are not enough to get our jobs done. Beyond the core, 
resjxjnse tallies put AppleScript as the productivity enhancer. 
Says Antoine Bcyeler, **its expandable". AppleScript allows 
Kenneth Woodruff to "refine, optimize, and organize the entire 
planet." If you don't know wlrai AppleScript is and/or what it can 
do for you, tlicn visiting Apple’s AppleScript Web site is reejuired 
reading for yt}U (alter you finish reading tiiis article, of course). 

Mirious editors also made the list. HexEdii is a general- 
purptise editor that atkiws you to edit the niw hexadecimal of files; 
simple and straightforward (and free). Fora more pcjwerful editor, 
consider General Edit from Quadrivio Coqxration, JJ. Urrea had 
this to say about treneral Edit: "Nothing else comes dose for 
decoding data files. After a one-time investment of several hours 
learning the syntax and designing display templates for my various 
file formats, I've saved many many times that. Now, itionths later, 
whenever I drag a file on General Fxlit and it automatically 
matches the lemj>lalc and comes up witli the file beautifully 
decoded, I think ‘wow, I’m so glad 1 sjxnt the time to do that!’" 
And w!iai discu-ssion of editors wouid Ixt complete without Bare 
Bones Sofm^ate's BBEdii and its freeware sibfing BBHdit lite. 
BBEilit is a higli ixfifomtance text editor. Ame Kuilman and Ryan 
Walker use it to author tlieir web pages. I use it for my wel) pages 
and just about any text editing that I need to do. 

Another set of tools dial garnered a good response were "RAD" 
tools. Grnxl old HyperCard fioin Apple is a favorite of Rol) Cozens, 
but Michael Git>l)s prefers SuperCard. "Hard to beat for mocking up 
cxintrol pimels, keyixids, and other simulated hardw'ane," says 


John C. D^ub is a mcml:>er of Pervasive Software’s Tangtj Development Team working on the Tango Editor. John enjoys 
spending his free time with his family: wife Michele, son Wade, and now daughter Fiona. You can contact John at 
I Lsoi ©polxix, cxim. 
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MidmcL ‘'In one case we Ixiilt an entry keypad From saaidi and 
had it up and ainning and miking lo anoditT simulalitMi application 
via Apple Events in 30 minutci fiat/ REALbasic is anothej- popular 
t(Kj), and widj a new book now available fmni O'Reilly, leiirning lo 
use REALl^asic has never been easier 

Last, but certainly not least, QC and S|X5tUght from Onyx 
Technology. QC is a great stress-testing tool, always having an 
important part of my testing and quality assurance plans. As for 
Spotlight, here's w^hai your fellow dcvelo|X!rs liave to say alx^ut 
it: "Tracks down the bugs you didift know existed/, “Makes 
finding Ixigs a breeze/, “Very useful for tracking down tliosc 
hard to find memory leaks and memory c<irruption.", "Amazing 
finder of pernicious bugs. Probably tlie best investment of 
money in development tools IVe ever made. I ain't imagine 
releasing code without Spotlighting it first. If ytiu're not using it, 
you're crazy/ Again, tliosc of you tliat are able to write bug-free 
c(xle t:an skip these last tools. 

rXK>L SnJFF 

Not all productivity enhancers are "traditionar development 
tools. One of my favorite applications is James TItotason’s 
DragJtiing. Ken Luke likes DragThing as well: “the tablied 
palettes really help nic get die most out of the desktop area/ 
File Buddy, a high-level file utility, and Snitch, the Get Info 
window enhancement, are hoih indispensable tcxds. FinderPop, 
turly’s uber-enhancement for contextual menus, is also high on 
die list: “My dispatch center when I want to do .something/, 
"Pop all those contextual menus in one menu/, "It r(x:ks/. 

In the previous section I listed some editors, but left one out 
of tile list as I fell it more appropriate for this section. 'ITiat editor 
is Tex-Edit Plus from Trans-dex Software. I think Rick Roy sums 
it up Ixrst. “A very inexpensive, fast, lightweight text editor with 
aggressive support for Appk\Script (yippee), and a developer 
who is really committed to customer satisfaction and quick 
responsCsS. It can open SimpleTexl read-only files in addition to 
any text file. Even lielps me with my in'ML ,which is nice 
l>ecause TextEdit Plus Is what 1 use to edit 1009^i of the HTML I 
create. An excellent product!” 

Rounding out die responses was CDFinder (a little tof>l that 
helps a lot if you have more than $ CDs), Default Folder (make 
your Open and Save dialogs smarter), the ACTION family of 
prcxlucts (Files, GoMac, Menus, WYSIWYG), and Typelt4Me 
(Ixicause weTe all lazy, check that, efficient typist.s). 

Oim-R Stuff 

One otlier item listed as a major time saver and life 
organizer is the PalmPilot and the Palm Desktfip software. Tlie 
Palm mnks on Alex Thomas' list. “Widiout question my Palm 
lllx lias had the most effect on my personal produaivity. 1 keep 
sysadmin and code hints as memos on it, along widi a bunch of 
things like an HTML manual, and use die address Ixxik for 
pnxiuct keys and web site pa.sswords/ The PalmPilot is one of 
those things that once you start lusing, you wonder how you 
ever managed to get along without it. 


One response that I did not expeci lo receive was from 
Kelsey Schwind. “What makes me productive? Wtien I can really 
concent rale and fcxrus. Tlie herbs Ginkgo and Got it Kola aid in 
iiiental clarity and 1 have noticed the difference.Others Find Jolt, 
Mt. Dew, and coffee to do the same for them as welf 

An<i one res|X)ase tliat I exjxxted to see but did not was the 
internet. Tlie boom of tlie 'Net has put a w^ealth c4 infonnation just 
a lew^ keystrokes away. Insick Mac intosh no longer takes up rows 
oF shelf sp^lce sint^ you can find it on die Tlie ‘Net alkiws us 
to cotnmunirate and discuss, seek help for pmbleins, ask advkx^, 
rant and rave, and all tlie while fxtying no mind to tlie vast distances 
tliat might ,sepanue us; in fad. tlie 'Net brings us dc^^r and allows 
us, Mac developc'rs, to luster an even greater community. Disai,ssion 
fomms like cooip.sys. mac.program met help and comp.sys.macoop.poweTplant 
help newbies finti an.s-wers and old timers discuss philo,so]^hsail 
issutjs alxHJi the latest Mac OS technolcjgy. The more we put online, 
dje tnoR* empowered we will Ixxxime. And of' aRtrse, f ango 2000 
is a great tail to help you .share infomiaiion online. 

Hapvy Shopping! 

If you’re looking for that perfec t gift lo get for yourself or 
some other geek in your life, lioficfully you've found a few new 
items Uj check out. I appreciate tools and toys that make my life 
a little simpler, a little easier I hope you find sometliing here* diat 
dfxfs the same for your life. Enjoy! 

URLs 

• Apple Qjmputer - <http://www.apple.com/> 

• CtKieWarrior - <http://www.codewarrior.com/> 

• Resorcerer - <http://www.mathemaesthetics.com/> 

• MacsBug - <http://developerapple.com/tools/debuggers/> 

• Ifie Debugger - <http://www.jasik.cofn/> 

• AppleScript - <http://www.apple.com/apptescript/> 

• General Edit - <http://www.quadrfvioxom/> 

• BBEdit (t.iie) - <http://www.bbGditcom/> 

• HyperCard - <http://www.3pple.com/hvpercard/> 

• SupeiGard - <http://www.incwell.eom/> 

■ REALbasic - <http://www.realbasic.eom/> 

• QC.Si S|K»d!glit - <http://wvyw.onyx-tech.com/> 

• DragTIiing - <http://www.dragthing.com/> 

• FileBuddy - <hTtp://www.skytag.com/> 

• Snitch - <http://www.niflyneato,com/> 

• FinderPop - <http;//www.finderpop.com/> 

• Tex-Edii Pki.s - <http://www.nearside.com/tranS‘tex/> 

• c'DFinder - <http://wwwxdfindGr.de/> 

• Default Folder “ <http://vyvvw.slclairsoft.com/DGfaiiltFoldef/> 

• ACrtON - <http://www.powGronswxom/> 

• Typefi4Mc - <httpi/wvvw.tiseiSLdtrcon.co.uk/-'r-ettDrG/Typelt4Meind©c to 

• PalmPilot - <http://www.palmpiiot.com/> 

• Ginkgo ^ Goal Kola - <http://www.mothematurexom/> 

• Jolt Cola - <http://wwwJollcola.com/> 

• Ml. Dew - <fittp://www.acts.org/roland/mt.dew/> 

• Coffee - <htlp://www.juanvaldGZXom/> 

• 1ango 2000 - <tittpJ/lango.pervasive.com/> 
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est New Product Most Innovative 


REALbasic 



The visual, object-oriented 
BASIC development 
environment for Macintosh^ 


Apple 

Iksign 


Best Macintosh 
User Experience 


UMi 


•ur award-winning IDE is the most advanced BASIC development tool available for the 
Macintosh. Build compiled applications faster and easier. It's easy enough for beginners and 
owerful enough for developers to use. 


100% Object-Oriented BASIC with classes, constructors, 
destructors, inheritance, properties, methods, virtual 
methods, multi-threading, and automatic garbage 
collection — even more object-oriented than C+-h! 

Build your applications on the Macintosh and deliver on 
both Macintosh {68k and PowerPC) and Windows (95, 
98 and NT) — including support for conditional 
compilation.* 

Port VB projects faster and easier by importing VB forms 
and modules. 

The debugger supports breakpoints, step over, step in, 
and step out — track down bugs faster and easier. 


• Create Internet-enabled applications using the TCP/IP 
socket tool. 

• Powerful multimedia tools with extensive QuickTime 
support and a Sprite animation engine. 

• Easily localize your applications including double-byte 
character support. 

• Extend functionality with PowerPC Shared Libraries, 
REALbasic native plugins, XCMDs and AppleScript. 

• Single database API with support for Oracle, Microsoft 
SQL Server, 4D Server, Dtf, PostgreSQL, Open Base, or 
any ODBC-compliant database. Includes a single-user 
SQL database engine. 


O REAL Software, Inc. 


)ovyhload a FREE trial version NOW! at www.realbasic.com or call 512.263.1233 for more information 

•Apple Design Awards awarded to REALbasic 1.0. Congratulations Geoff and Jeannie! **MacWorld rating awarded to HEALbasic 2,0.2. 

' . iWindows compilation and database support require Professional Edition. REALbasic is a trademark of REAL Software, Inc. 















Whoa. New technology. 
I need updated tools. 



CodeWarrior solves problems. We're continually updating our award-winning 
Mac^hosted development suite so your applications can take advantage of the 
Latest technologies from Apple, Thinking about Hac OS Carbon or ALtiVec? 

So is fietrowerks* CodeWarrior - still fastv- powerful, easy to use- 
No problem with that, right? 

PROBLEM SOLVED. CODEWARRIOR. 

1 . 800 . 377.5416 

For more information on CodeWarrior's support for new Apple technology^ check out: 

www.metrowerks.com/newtecK 






















